Pular para o conteúdo

Importa o resultado de uma consulta SQL em um banco de dados externo para uma tabela de projeto do PlaidCloud. A consulta é executada no banco de dados remoto; somente o conjunto de resultados é trazido para o PlaidCloud.

Difere de Importar tabelas de banco de dados externo porque você mesmo escreve o SQL, o que é útil para junções, filtros ou agregações complexas que você quer que o banco de dados de origem realize antes de os dados chegarem ao PlaidCloud.

Tabela de Importar SQL


Para estabelecer uma Conexão de banco de dados, consulte Conexões de dados do PlaidCloud

Tabela de destino

A seleção de destino para importações é limitada a tabelas, pois as visões não contêm dados subjacentes.

Opção dinâmica

A opção dinâmica permite especificar uma tabela por meio de texto, incluindo variáveis. Isso é útil ao usar fluxos de trabalho orientados por variáveis, nos quais as referências a tabelas e visões são relativas às variáveis especificadas.

Um exemplo que usa a variável current_month para apontar dinamicamente para a tabela de destino:

legal_entity/inputs/{current_month}/ledger_values

Opção estática

Quando você quiser uma tabela específica como destino da importação, deixe a caixa Dinâmico desmarcada e selecione a tabela de destino.

Se a tabela de destino não existir, selecione o botão Criar novo para criar a tabela no local desejado.

O Explorador de tabelas está sempre disponível em qualquer seleção de tabela. Clique no botão Explorador de tabelas à direita da seleção de tabela e uma janela do Explorador de tabelas será aberta.

Nesta seção, escreva a consulta SQL que retorna os dados necessários.

Pré-visualização

Clique em Pré-visualização na guia Origem para ver até 100 linhas do que a etapa leria, sem executá-la. Se o resultado for mais longo, a pré-visualização informa que mostra as primeiras linhas e que você precisa executar a etapa para ler todas.

A pré-visualização preenche as variáveis do projeto e do fluxo de trabalho do mesmo modo que uma execução. Ela não oferece suporte a formatos de variável como {x:>9} e não consegue preencher uma variável que só tem valor durante uma execução, como um valor de gatilho.

A pré-visualização apenas lê dados. Ela recusa uma consulta que possa alterar qualquer coisa e mostra uma mensagem em vez de linhas:

  • A pré-visualização só oferece suporte a funções SQL padrão. Execute a etapa para ver os resultados. A consulta usa uma função que a pré-visualização não consegue verificar como somente leitura. Execute a etapa para ver o resultado.
  • Uma consulta que não seja um único SELECT, ou cujas variáveis se expandam para uma instrução que grava, é recusada.

A pré-visualização não está disponível em um projeto bloqueado, em conexões SQL Server, Oracle ou SQLite, nem para etapas executadas por meio de um agente, como a etapa Agent Remote Execution of SQL.

As importações de SQL têm a opção de tentar detectar o tipo de dados durante o carregamento ou de definir todas as colunas com o tipo Texto. Definir os tipos de dados dinamicamente pode ser mais rápido se os dados estiverem limpos, mas pode causar problemas em algumas circunstâncias.

Por exemplo, se a maior parte dos dados parecer numérica, mas também houver algum texto, a importação pode tentar defini-la como numérica, causando problemas de carregamento por tipos de dados incompatíveis. Ou pode haver problemas se houver um código de produto numérico de 16 dígitos, por exemplo. Ele cortaria os zeros à esquerda, resultando em um número em vez de um código de 16 dígitos.

Definir todos os dados como texto, porém, exige uma etapa Extract posterior para converter os tipos de dados que não deveriam ser texto para o tipo apropriado, como datas ou valores numéricos.


Sintoma Causa provável
A etapa levou visivelmente mais tempo que o normal, até cerca de meia hora a mais, sem que nada mais mudasse na sua consulta, conexão ou volume de dados O worker em segundo plano que executava a importação foi interrompido no meio do caminho (uma reinicialização ou remoção do lado da plataforma, não algo no seu fluxo de trabalho), e a plataforma tentou novamente a importação da tabela para você. A nova tentativa só começa quando a interrupção é detectada, o que explica o tempo extra.
A etapa ainda terminou com sucesso depois desse atraso A nova tentativa substitui totalmente o conteúdo da tabela, então o resultado é o mesmo de uma única execução limpa; não há mais nada a verificar ou refazer.
A etapa falha com “has already been attempted and cannot be safely re-run” Em uma etapa Importar SQL, essa recusa não ocorre mais: uma interrupção no meio da execução é tentada novamente. Você ainda a verá, por projeto, ao restaurar um arquivo de projeto ou carregar uma dimensão, em que executar de novo criaria uma duplicata em vez de substituir algo. Abra um chamado de suporte se você a vir em uma própria etapa Importar SQL.