Importar SQL
Descrição
Seção intitulada “Descrição”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.
Parâmetros de importação
Seção intitulada “Parâmetros de importação”
Origem e destino
Seção intitulada “Origem e destino”Conexão de banco de dados
Seção intitulada “Conexão de banco de dados”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_valuesOpçã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.
Consulta SQL
Seção intitulada “Consulta SQL”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.
Detecção do tipo de coluna
Seção intitulada “Detecção do tipo de coluna”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.
Solução de problemas
Seção intitulada “Solução de problemas”| 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. |