Skip to main content

Blue icon with floppy disk. Ferramenta Gravar Dados In-DB

Use a ferramenta Gravar Dados In-DB para criar ou atualizar uma tabela diretamente no banco de dados.

A opção de processamento no banco de dados (in-DB) permite a combinação e a análise de grandes conjuntos de dados sem a necessidade de extrair os dados do banco, o que possibilita melhorias de desempenho significativas em relação aos métodos tradicionais de análise. Para mais informações sobre a categoria de ferramentas No Banco de Dados, consulte Visão geral do processamento em banco de dados.

Configurar a ferramenta

Modo de saída: selecione a opção apropriada para gravar os dados. As opções incluem...

  • Agregar existente: acrescenta todos os dados a uma tabela existente. A saída consiste em registros anteriores + registros posteriores.

  • Excluir dados e agregar: exclui todos os registros originais da tabela e, em seguida, acrescenta os dados à tabela existente. Observe que esse modo é diferente dependendo do banco de dados para o qual você quer gravar:

    • Bancos de dados do Oracle: usa a instrução DELETE.

    • Bancos de dados do SQL Server: usa a instrução TRUNCATE TABLE porque é um método mais eficiente. Você precisa das permissões ALTER ou TRUNCATE na tabela.

  • Substituir tabela (descartar): descarta completamente a tabela existente e cria uma nova.

  • Criar nova tabela: cria uma nova tabela. Não substitui a tabela existente.

  • Criar tabela temporária: grava em uma tabela temporária que fica disponível até o final da sessão. Essa opção é útil para criar macros preditivas in-DB porque mantém temporariamente os metadados. Se essa opção for selecionada, o campo "Nome da tabela" é desabilitado e exibe a mensagem "um nome exclusivo de tabela temporária é gerado em cada execução".

  • Atualizar linhas: atualiza linhas existentes em uma tabela com base nos registros de entrada.

  • Excluir linhas: exclui linhas existentes em uma tabela com base nos registros de entrada.

  • Nome da tabela: digite o nome da tabela do banco de dados a ser criada ou atualizada.

Mapeamento dos campos para agregar (ou Mapa de campos (SET) quando Atualizar linhas for o Modo de saída selecionado): esta área se torna ativa quando Agregar existente ou Excluir dados e agregar é escolhido acima.

Escolha um modo de configuração:

  • Configurar automaticamente por nome: alinha os campos com base no nome dos campos.

  • Configurar automaticamente por posição: alinha os campos com base na ordem dos campos no fluxo de dados.

Quando os campos forem diferentes: selecione como lidar com campos de dados não conformes nas opções do menu suspenso.

  • Erro - Parar processamento: gera um erro na janela de resultados e interrompe o processamento.

  • Gerar campos aplicáveis: os campos aplicáveis são incluídos. Valores nulos preenchem campos vazios.

Opções: esta área se torna ativa quando Atualizar linhas ou Excluir linhas é selecionado como o Modo de saída.

  • Mapa de campos (WHERE): forma a instrução condicional para os modos de saída "Atualizar linhas" e "Excluir linhas".

Limitações

  • As opções de saída para atualizar/excluir não são compatíveis com aliases de coluna no momento.

  • A opção para atualizar a saída exige que todos os nomes de campo correspondam aos nomes de campo da tabela-alvo para a opção "Mapeamento dos campos para agregar – Configurar automaticamente por nome", e que o número de campos corresponda ao número de campos da tabela-alvo para a opção "Mapeamento dos campos para agregar – Configurar automaticamente por posição".

  • Atualizar/Excluir é compatível somente com conexões ODBC do SQL Server.

  • As opções de saída para atualizar/excluir não são compatíveis com a atualização ou exclusão de valores nulos no momento. Os operadores de comparação (como = ou !=) usados para consultas de exclusão e atualização do Alteryx retornam "desconhecido" para valores nulos. Para obter mais informações, consulte a documentação do Microsoft SQL Server.

  • Ao agregar dados usando a ferramenta Gravar Dados In-DB, todas as colunas na tabela-alvo devem ser incluídas na instrução INSERT para que ela seja válida. Colunas ausentes serão adicionadas com um valor nulo.

Estrutura de consulta

Exemplos de consultas para as opções de modo de saída "Atualizar linhas" e "Excluir linhas":

Atualizar linhas

WITH upstream AS ( ... ) UPDATE t SET t.col2 = (SELECT col2 FROM upstream u WHERE u.col1 = t.col1 AND ...), ... FROM target_ t WHERE EXISTS ( SELECT * FROM upstream u WHERE u.col1 = t.col1 AND ... )

Excluir linhas

WITH upstream AS ( ... ) DELETE t from target_ t WHERE EXISTS ( SELECT * FROM upstream u WHERE u.col1 = t.col1 AND ... )