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

Este tópico fornece informações sobre como instalar e configurar o Snowflake Connector for Google Analytics Raw Data pelo Snowsight.

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

Nota

O Snowflake Connector for Google Analytics Raw Data também pode ser configurado por meio de SQL. A configuração por meio de SQL é considerada um tópico avançado. Para obter mais informações, consulte Configuração do Snowflake Connector for Google Analytics Raw Data usando SQL.

Para configurar o conector, faça o seguinte:

  1. Faça login na Snowsight como usuário com a função ACCOUNTADMIN ou qualquer outra que atenda aos seguintes requisitos:

    • Você precisa ter estes privilégios no nível da conta:

      • EXECUTE TASK com a opção de concessão

      • EXECUTE MANAGED TASK com a opção de concessão

    • EVENT_TABLE deve estar habilitado na conta.

    • Para acessar o warehouse, você deve ter pelo menos um dos seguintes privilégios:

      • O privilégio CREATE WAREHOUSE na conta

      • O privilégio OWNERSHIP no warehouse

      • O privilégio USAGE no warehouse (com a opção de concessão)

    • Para acessar o banco de dados, você deve ter pelo menos um dos seguintes privilégios:

      • O privilégio CREATE DATABASE na conta

      • O privilégio OWNERSHIP no banco de dados

      • O privilégio USAGE no banco de dados (com a opção de concessão)

    • Para acessar o esquema, você precisa ter pelo menos um dos seguintes privilégios:

      • O privilégio CREATE DATABASE na conta

      • O privilégio OWNERSHIP no banco de dados

      • O privilégio USAGE no banco de dados (com a opção de concessão)

      • O privilégio CREATE SCHEMA no banco de dados

      • Os privilégios USAGE, CREATE TABLE, CREATE VIEW no esquema (com a opção de concessão)

    • Opcional: Para ter acesso às funções, você pode criar uma nova ou selecionar uma função que já existe para ser atribuída à função de aplicativo DATA_READER. Para criar uma nova função, você precisa ter o privilégio CREATE ROLE na conta. No entanto, isso não é necessário para concluir a configuração.

  2. No menu de navegação, selecione Catalog » 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:

    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.

    Se você não estiver conectado como um usuário com a função ACCOUNTADMIN, confirme se você atende aos seguintes requisitos:

    • Você precisa ter o privilégio CREATE INTEGRATION.

    • Se as integrações foram criadas anteriormente por outras funções, a propriedade dessas integrações precisa ser transferida para a sua função.

    • Se o banco de dados CONNECTORS_SECRET não existe, então você precisa do privilégio CREATE DATABASE.

    • Se CONNECTORS_SECRET banco de dados existe, mas foi criado por outra função, então você precisa destes privilégios:

      • USAGE WITH GRANT OPTION

      • CREATE SCHEMA WITH GRANT OPTION

    • Se o esquema CONNECTORS_SECRET.APP_NAME existe, mas foi criado por outra função, então você precisa destes privilégios:

      • USAGE WITH GRANT OPTION

      • CREATE SECRET

      • CREATE NETWORK RULE

    • Se CONNECTORS_SECRET.APP_NAME.SECRET existe, mas foi criado por outra função, a propriedade dele precisa ser transferida para a sua função.

    • Se CONNECTORS_SECRET.APP_NAME.NETWORK_RULE existe, mas foi criado por outra função, a propriedade dele precisa ser transferida para a sua função.

    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

Linguagem: Português