Setting up a SQL connector

Introdução

Esta página contém as instruções sobre como criar um novo conector SQL e conectá-lo aos seus sistemas de origem.

Pré-requisitos

Supõe-se que as ferramentas de desenvolvimento descritas em Configuração de um ambiente de teste local estejam instaladas.

Criando um novo conector SQL

Se você quiser criar um novo conector SQL, pode baixar o conector modelo que contém a configuração básica para um conector SQL.

Iniciar Repositório

É recomendável armazenar seu conector em um sistema de controle de versão, por exemplo, GitHub.

Etapa	Ação
1	Crie um novo repositório que contenha o diretório completo do conector. Esse diretório deve ter a mesma estrutura que o conector baixado (modelo).

Configurar Extração

Primeiro, as configurações de extração precisam ser definidas, para apontar para o sistema de origem desejado e o banco de dados de preparação. Essas etapas de configuração devem ser executadas uma vez para cada ambiente de desenvolvedor e para o ambiente de produção.

Etapa 1: escolha o método de extração

Cada conector vem com um conjunto de métodos de extração específicos. Um dos métodos de extração precisa ser configurado para extrair os dados de origem.

Método de extração	Description
Carregar de arquivo	Configure uma tarefa CData para o extrator Carregar de arquivo . Consulte Extratores: Carregar do arquivo. “ Use uma consulta personalizada específica para esse conector, que é fornecida em extractors/load-from-file/instructions.md.
Carregar da fonte	Para carregar dados de entrada de um sistema de origem, use as instruções específicas localizadas em extractors/load-from-source/instructions.md. O extrator load-from-source está disponível apenas em conectores feitos para sistemas de origem específicos, por exemplo, um conector Purchase-to-Pay para SAP.

Etapa 2: limitar os dados de origem

Certifique-se de definir os filtros apropriados para o seu extrator, para carregar apenas os dados necessários para sua análise. Por exemplo, limite os dados aos últimos 6 meses ou apenas a um departamento específico de interesse.

Instruções específicas sobre filtragem de dados de entrada podem ser encontradas em instructions.md do extrator.

Etapa 3: configurar o script de extração

Se o conector usar CData Sync para extração de dados, o script extract_cdata.ps1 deverá ser apontado para o trabalho correto. Siga estas etapas para configurar o script de extração.

Etapa	Ação
1	No diretório scripts/ , renomeie config_template.json como config.json. config.json é ignorado pelo Git, de modo que os ambientes de desenvolvimento e produção podem usar diferentes configurações de extração.
2	Em config.json, altere o texto JOB_NAME_CREATED_IN_CDATA para o trabalho CData que acabou de ser criado.

Se o conector não usar CData Sync para extrair dados, use as instruções específicas fornecidas em instructions.md.

Configurar Transformação

Para executar a transformação no banco de dados de preparação correto, profiles.yml precisa ter uma referência ao seu banco de dados de preparação para este conector. Essas etapas de configuração precisam ser executadas uma vez para cada ambiente de desenvolvedor e para o ambiente de produção. Siga estas etapas para configurar a transformação.

Etapa	Ação
1	Copie o conteúdo de transformations/profiles.yml do seu conector.
2	Cole o conteúdo em seu profiles.yml pessoal para adicioná-los. O pessoal profiles.yml deve ficar localizado fora do diretório do conector.
3	Altere o conteúdo para apontar para seu banco de dados de preparação.

Configurar carga

Para realizar a geração de cache usando o script load.ps1, ele deve ser apontado para o ambiente do Process Mining no qual a versão do aplicativo correspondente está ativa. Siga estas etapas para configurar o script de extração.

A etapa 1 pode ser omitida se já tiver sido realizada durante a configuração da extração.

Etapa	Ação
1	No diretório scripts/ , renomeie config_template.json como config.json. config.json é ignorado pelo Git, de modo que os ambientes de desenvolvimento e produção podem usar diferentes configurações de extração.
2	Em config.json, altere o texto PROCESS_MINING_ENVIRONMENT para o ambiente no qual a liberação está ativa.

Próximas Etapas

Quando o conector SQL é configurado corretamente, ele pode ser executado. Consulte Execução de um conector SQL.