Running a SQL connector

Introdução

Esta página contém instruções sobre como executar um conector SQL usando scripts.

Pré-requisitos

O run.ps1 e load.ps1 precisam ser executados no mesmo servidor que a instalação do Process Mining para produção. Os scripts extraction_cdata.ps1 e transform.ps1 também podem ser executados em outros locais.

É assumido que:

• as ferramentas de desenvolvimento descritas em Configuração de um ambiente de teste local estão instaladas.
• o conector SQL é configurado conforme descrito em Configuração de um conector SQL.
  Observação:

  O diretório scripts/ do conector contém um conjunto de scripts padrão para executar e agendar a extração, transformação e carregamento de dados.

Execução de um conector

Siga estas etapas para executar um conector, extrair, transformar e carregar os dados.

Etapa	Ação
1	Iniciar o Windows PowerShell como Admin.
2	Vá para o diretório scripts/ .
3	Execute run.ps1.

Executando apenas extração

Siga estas etapas para executar apenas a extração.

Etapa	Ação
1	Inicie o Windows PowerShell.
2	Vá para o diretório scripts/ .
3	Execute extraction_cdata.ps1.

Observação:

Se seu conector não usar o CData Sync para extração de dados, o nome do extraction_ script será diferente.

Executando apenas transformações

Siga estas etapas para executar apenas as etapas de transformação.

Etapa	Ação
1	Inicie o Windows PowerShell.
2	Vá para o diretório scripts/ .
3	Execute transform.ps1.

Cada etapa de transformação também pode ser executada individualmente.

Somente carga em execução

Siga estas etapas para executar apenas as etapas de carga.

Etapa	Ação
1	Iniciar o Windows PowerShell como Admin.
2	Vá para o diretório scripts/ .
3	Execute load.ps1.

Erros de depuração

Um arquivo de log LogFile.log é criado ao executar os scripts. Este arquivo de log contém todos os estágios da execução do trabalho e os carimbos de data/hora associados. O arquivo de log também retorna um conjunto mínimo de códigos de erro, que podem fornecer orientações adicionais.

Carregar

Para obter mais detalhes sobre a geração do cache, verifique cache_generation_output.log que é gerado no diretório em que seu script de carregamento está localizado.

Extrações de CData

Para obter mais detalhes sobre as execuções de trabalho do CData Sync, acesse sua instância do CData Sync e verifique a guia Registro em log e Histórico do seu trabalho. Veja a ilustração abaixo.

Para registrar mais detalhes, defina a Verbosidade do arquivo de log como Verbose e execute o script de extração extraction_cdata.ps1 novamente.

Abaixo está uma visão geral dos códigos de retorno de um trabalho CData Sync.

Código	Descrição do registro
0	Extração com Sucesso para o trabalho.
-1	Extração com FALHA para o trabalho.
-2	Falha ao realizar a extração. Verifique suas configurações ou procure a guia Registro em log e Histórico para o seu trabalho.

Transformações

O arquivo de log também retorna um conjunto de códigos de erro do script de transformação. Abaixo está uma visão geral dos códigos de erro.

Código	Descrição do registro
-1	Falha geral dbt run ou dbt test . Isso significa que há um problema com a configuração atual ou com a configuração. Verifique o LogFile.log para mais detalhes.
0*	A chamada dbt foi concluída sem erros.
1*	A invocação dbt foi concluída com pelo menos um erro gerenciado (por exemplo erro de sintaxe do modelo, permissões incorretas etc.). A execução foi concluída, mas alguns modelos podem ter sido ignorados. LogFile.log contém informações extras que informam se o erro ocorreu na fase dbt run ou na fase dbt test .
2*	A invocação dbt foi concluída com um erro não tratado (por exemplo, uma interrupção de rede).

• 0, 1 e 2 são códigos de retorno específicos do dbt . Consulte a documentação oficial do dbt sobre códigos de saída.

Depurando Grandes Projetos Dbt

Se a execução da transformação levar muito tempo, response.txt no diretório scripts/ poderá ser inspecionado. Ele contém as respostas em tempo real do dbt. Após dbt test ou dbt run serem concluídos, as informações são anexadas a LogFile.log e o arquivo temporário é excluído.

Agendamento de extrações de dados

Também é possível agendar extrações de dados em intervalos regulares. Consulte Agendamento da extração de dados.