Instalação e configuração do Snowflake Connector for Google Analytics Raw Data¶

Instalação do Snowflake Connector for Google Analytics Raw Data¶

Para instalar o conector, faça o seguinte:

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

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

3. Procure o Snowflake Connector for Google Analytics Raw Data, depois selecione o bloco para o conector.

4. Na página do Snowflake Connector for Google Analytics Raw Data, 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 Options->Application name, entre no banco de dados a ser usado como o banco de dados para a instância do conector. Este banco de dados é criado automaticamente para você.

   2. 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 que é usado pelo conector para sincronizar os dados do Google Analytics. Em uma etapa posterior, você criará um warehouse separado para este fim.

   3. Selecione Get.

5. Selecione Open.

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

Configuração do Snowflake Connector for Google Analytics Raw Data¶

Para configurar o conector, faça o seguinte:

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

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

3. Selecione Snowflake Connector for Google Analytics Raw Data.

   O assistente de configuração é iniciado.

4. Pré-requisitos

   1. Certifique-se de que todos os pré-requisitos da lista sejam atendidos e marque-os como concluídos.

   2. Clique em Start configuration

5. Configuração do warehouse, banco de dados, esquema e função

   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).

   Preencha os seguintes campos e selecione Configure na parte inferior da tela:

   Campo	Descrição
   Warehouse	Digite o identificador de um novo warehouse virtual dedicado para o conector ou selecione um já existente. 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. Alternativamente, você pode selecionar um warehouse existente.
   Destination Database	Identificador para um novo banco de dados que conterá o esquema com as tabelas para os dados do Google Analytics no Snowflake. Os dados baixados do Google Analytics chegarão aqui. Especifique um nome que seja único para sua conta. O nome do banco de dados deve ser um identificador de objeto válido. O processo de configuração cria um novo banco de dados com o nome especificado. Alternativamente, você pode selecionar um banco de dados existente.
   Destination Schema	Identificador para um novo esquema que conterá os dados do Google Analytics no Snowflake. O Snowflake Connector for Google Analytics Raw Data ingere dados do Google Analytics em tabelas neste esquema. O nome do esquema deve ser um identificador de objeto válido. O processo de configuração cria um novo esquema com o nome especificado. Alternativamente, você pode selecionar um esquema existente.
   Role	Identificador para uma nova função personalizada para o conector. Especifique um nome que seja único para sua conta. O nome da função deve ser um identificador de objeto válido. A função é uma função no nível da conta que terá acesso de leitura aos dados ingeridos. Alternativamente, você pode selecionar uma função existente.

   Se o banco de dados de destino e o esquema existentes forem fornecidos, a propriedade das tabelas e exibições regulares existentes será transferida para o Snowflake Connector for Google Analytics Raw Data. Isso exclui, por exemplo, as tabelas externas e exibições materializadas. Além disso, nada será transferido em esquemas gerenciados.

   Pode levar algum tempo para que o processo de configuração seja concluído. Quando o processo de configuração for concluído com êxito, o assistente de configuração avançará para Authentication.

6. Configuração de autenticação

   O Snowflake Connector for Google Analytics Raw Data oferece suporte a dois métodos de autenticação: OAuth e Contas de serviço. Cada um dos métodos requer configuração adicional no seu projeto GCP.

   Para obter mais informações sobre como configurar cada autenticação, consulte:

   • Configuração da autenticação da conta de serviço para Google Cloud Platform (GCP)

   • Configuração da autenticação OAuth para Google Cloud Platform (GCP)

   Se estiver usando o método de autenticação Conta de serviço, forneça um arquivo JSON com credenciais da conta de serviço.

   Alternativamente, você pode preencher os seguintes campos:

   Campo	Descrição
   Client email	E-mail da conta de serviço do Google gerado durante o processo de criação da conta de serviço no projeto Google Cloud Platform.
   Private key	Chave privada gerada durante o processo de criação da conta de serviço no projeto Google Cloud Platform.

   Certifique-se de ter removido -----BEGIN PRIVATE KEY-----, -----END PRIVATE KEY----- e \\n.

   Se estiver usando o método de autenticação Oauth2, preencha os seguintes campos:

   Campo	Descrição
   Client id	ID do cliente gerado no projeto Google Cloud Platform.
   Client secret	ID do segredo do cliente gerado no projeto do Google Cloud Platform.

   Selecione Connect

   Se você tiver selecionado a autenticação Oauth2, será apresentado o fluxo de diálogo de autenticação do Google OAuth2.

   Na caixa de diálogo, faça login no Google para concluir o fluxo de autenticação do Google OAuth2.

   Pode levar algum tempo para que o processo de autenticação seja concluído.

7. Validação da fonte

Após a conexão bem-sucedida, o conector verificará se pode acessar os dados do Google Analytics. Em caso de erro, o conector irá guiá-lo com instruções adicionais.

Se o processo for concluído com êxito, você poderá começar a configurar a ingestão. Para mais informações, consulte Configuração da ingestão de dados para seu Snowflake Connector for Google Analytics Raw Data