Configuração do Snowflake Connector for PostgreSQL usando o Snowsight

Nota

O Snowflake Connector for PostgreSQL está sujeito aos Termos do conector.

Nota

Para contas onde o parâmetro AUTOCOMMIT é definido como falso, ele deve ser definido como verdadeiro no nível das sessões durante a configuração como verdadeiro usando o comando SQL ALTER SESSION SET AUTOCOMMIT=TRUE.

O processo de configuração do Snowflake Connector for PostgreSQL usando o Snowsight inclui as seguintes etapas:

Neste tópico:

Configuração do registro em log do conector

O Snowflake Connector for PostgreSQL usa a tabela de evento para armazenar eventos e logs gerados pelo código do conector. A configuração de uma tabela de evento é uma etapa obrigatória.

Nota

Se a tabela de evento já estiver configurada para a conta usada para o conector, ignore esta etapa.

Para criar uma tabela de evento, faça o seguinte:

CREATE EVENT TABLE IF NOT EXISTS <fully_qualified_event_table_name> CHANGE_TRACKING = TRUE;
ALTER ACCOUNT SET EVENT_TABLE = <fully_qualified_event_table_name>;
Copy

Onde:

fully_qualified_event_table_name

Especifique o nome da tabela de evento.

Mais informações sobre uma tabela de evento podem ser encontradas aqui.

Instalação do Snowflake Connector for PostgreSQL

O seguinte procedimento descreve como instalar o conector:

  1. Entre em Snowsight como um usuário com a função ACCOUNTADMIN.

  2. No painel de navegação à esquerda, selecione Data Products » Marketplace.

  3. Procure o Snowflake Connector for PostgreSQL, depois selecione o bloco para o conector.

  4. Na página do Snowflake Connector for PostgreSQL, selecione Get.

    Isto exibe uma caixa de diálogo que você utiliza para iniciar a parte inicial do processo de instalação.

    Na caixa de diálogo, configure o seguinte:

    1. No campo Warehouse used for installation, selecione o warehouse que você deseja usar para a instalação do conector.

      Nota

      Este não é o mesmo warehouse usado pelo conector para sincronizar dados do banco de dados MySQL. Em uma etapa posterior, você criará um warehouse separado para este fim.

    2. Opcionalmente, em Options » Application name, você pode mudar o nome do aplicativo.

    3. Selecione Get.

  5. Uma caixa de diálogo aparece com a notificação: Successfully Installed. Para continuar com a configuração, selecione Configure.

    A caixa de diálogo se fecha e a página do Snowflake Connector for PostgreSQL exibe a UI para configurar e gerenciar o conector.

Opcional: Instalação de múltiplas instâncias de Snowflake Connector for PostgreSQL

É possível instalar várias instâncias do mesmo aplicativo conector em sua conta Snowflake.

Para instalar uma instância de aplicativo adicional, faça o seguinte:

  1. Faça login no Snowsight.

  2. Navegue até o Snowflake Marketplace e selecione o aplicativo para o qual deseja instalar outra instância. A página de detalhes do aplicativo é exibida.

  3. Clique em Add instance. A caixa de diálogo de instalação é exibida.

  4. Forneça o nome da instância e selecione o warehouse a ser usado durante a instalação.

  5. Selecione Get para iniciar o processo de instalação.

Adicionar instâncias de conector pode levar vários minutos. Quando o processo de instalação for concluído, você receberá uma notificação por e-mail.

Atenção

Para evitar a corrupção de dados ingeridos, durante a configuração do conector, sempre use um esquema de banco de dados diferente de todos os outros aplicativos nativos.

Para acessar as instâncias do aplicativo do conector instalado, faça o seguinte:

  1. Faça login no Snowsight.

  2. No menu de navegação, selecione Data Products » Apps.

  3. Selecione a instância de seu aplicativo para acessá-lo.

Configuração do Snowflake Connector for PostgreSQL

  1. Entre em Snowsight como um usuário com a função ACCOUNTADMIN.

  2. No menu de navegação, selecione Data Products » Apps.

  3. Procure por Snowflake Connector for PostgreSQL e, em seguida, selecione-a. Agora você será movido para a página do assistente de instalação, que o guiará durante o processo de configuração.

Configure o aplicativo da seguinte forma:

Etapa 1: Conclusão dos pré-requisitos

Conclua as seguintes etapas de pré-requisito para definir seu banco de dados e agente:

Etapa

Descrição

Provide access to the source database

Pré-requisitos para fontes de dados do Snowflake Connector for PostgreSQL

Download and install the Agent

Configuração do contêiner do Agent Snowflake Connector for PostgreSQL

Selecione Mark as done para cada etapa concluída.

Selecione Start configuration.

Etapa 2: Configuração

Na caixa de diálogo de configuração, insira valores para os seguintes campos:

Campo

Descrição

Compute Warehouse

Identificador para um novo warehouse virtual dedicado para o conector. Este warehouse será usado para processar dados obtidos do agente e colocá-los na tabela de destino.

Especifique um nome que seja único para sua conta. O nome do warehouse deve ser um identificador de objeto válido.

Nota

Não especifique o mesmo warehouse que você selecionou no início da instalação do conector.

O processo de configuração cria um novo warehouse X-Small com o nome especificado.

Operational Warehouse

Identificador para um novo warehouse virtual dedicado para o conector. Este warehouse será usado para gerenciar as atividades do conector e seus agentes.

Especifique um nome que seja único para sua conta. O nome do warehouse deve ser um identificador de objeto válido.

Nota

Não especifique o mesmo warehouse que você selecionou no início da instalação do conector.

O processo de configuração cria um novo warehouse X-Small com o nome especificado.

Role

Identificador para uma nova função personalizada para o agente.

Especifique um nome que seja único para sua conta. O nome da função deve ser um identificador de objeto válido.

O processo de configuração cria uma nova função com o nome especificado.

User

Identificador para um novo usuário que o agente usará para autenticar no Snowflake.

Especifique um nome que seja exclusivo dentro do banco de dados selecionado. O nome do usuário deve ser um identificador de objeto válido.

O processo de configuração cria um novo usuário com o nome especificado e do tipo SERVICE.

Nota

Por padrão, os campos são definidos como os nomes dos objetos que são criados quando você configura o conector. Snowflake recomenda o uso de novos objetos para estes campos. No entanto, você pode especificar os nomes dos objetos existentes, se necessário (por exemplo, se você estiver reinstalando o conector).

Selecione Configure.

Etapa 3: Verificação da conexão do Agent

Verifique a conexão do agente ao Snowflake da seguinte forma:

  1. Selecione Generate file para gerar o arquivo de configuração inicial para o agente.

    Cuidado

    Sempre que você clicar em Generate file, um novo arquivo será gerado, com um novo conjunto de chaves de acesso temporárias para o usuário do agente. O usuário é automaticamente alterado para usar essas novas chaves para autenticação. Se você já tiver o agente em execução com outro conjunto de chaves, ele será desconectado do Snowflake e deixará de funcionar.

  2. Usando o arquivo snowflake.json gerado, prossiga para configurar o agente, conforme descrito em Configuração do contêiner do Agent Snowflake Connector for PostgreSQL. Em seguida, volte para o Snowsight.

  3. Selecione Refresh para verificar a conectividade com o agente. O aplicativo confirmará que o agente foi conectado com sucesso e uma caixa de diálogo de confirmação será exibida.

  4. Selecione Define data to sync para continuar.

Próximos passos

Após completar estes procedimentos, siga os passos em Configuração do contêiner do Agent Snowflake Connector for PostgreSQL.

Linguagem: Português