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

    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 Autenticação.

  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 os símbolos —–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

Configuração do Snowflake Connector for Google Analytics Raw Data usando instruções SQL

Para configurar o conector usando instruções SQL, faça o seguinte:

Nota

Para provisionar o conector e configurar a conexão, você terá que usar procedimentos armazenados definidos no esquema PUBLIC do banco de dados que serve como instância do banco de dados de instalação do conector.

Antes de chamar esses procedimentos armazenados, selecione esse banco de dados como o banco de dados a ser utilizado para a sessão.

Por exemplo, se esse banco de dados for nomeado snowflake_connector_for_google_analytics_raw_data, execute o seguinte comando:

USE DATABASE snowflake_connector_for_google_analytics_raw_data;
Copy

Preparação de um warehouse, uma função de proprietário de dados e um banco de dados de destino

  1. Conceda o uso em permissões especificadas de warehouse e execução de tarefas ao aplicativo do conector.

    USE ROLE accountadmin;
CREATE WAREHOUSE google_analytics_raw_data_warehouse with warehouse_size = 'X-Small';
GRANT USAGE ON WAREHOUSE google_analytics_raw_data_warehouse TO APPLICATION snowflake_connector_for_google_analytics_raw_data;
GRANT EXECUTE TASK ON ACCOUNT TO APPLICATION snowflake_connector_for_google_analytics_raw_data;
    Copy

  2. Crie a função de proprietário de dados.

    USE ROLE accountadmin;
CREATE OR REPLACE ROLE google_analytics_raw_data_resources_provider;
GRANT CREATE DATABASE ON ACCOUNT TO ROLE google_analytics_raw_data_resources_provider;
GRANT USAGE ON WAREHOUSE google_analytics_raw_data_warehouse TO ROLE google_analytics_raw_data_resources_provider;
GRANT ROLE google_analytics_raw_data_resources_provider TO USER ADMIN;
    Copy

  3. Crie um banco de dados e um esquema de destino.

    Você também pode usar um banco de dados e um esquema de destino existentes, especialmente se estiver reinstalando o conector.

    USE ROLE google_analytics_raw_data_resources_provider;
CREATE DATABASE google_analytics_raw_data_dest_db;
CREATE SCHEMA google_analytics_raw_data_dest_db.google_analytics_raw_data_dest_schema;
    Copy

  4. Adicione as concessões necessárias no banco de dados de destino ao aplicativo.

    USE ROLE accountadmin;
GRANT USAGE ON DATABASE google_analytics_raw_data_dest_db TO APPLICATION snowflake_connector_for_google_analytics_raw_data;
GRANT USAGE ON SCHEMA google_analytics_raw_data_dest_db.google_analytics_raw_data_dest_schema TO APPLICATION snowflake_connector_for_google_analytics_raw_data;

GRANT CREATE TABLE ON SCHEMA google_analytics_raw_data_dest_db.google_analytics_raw_data_dest_schema TO APPLICATION snowflake_connector_for_google_analytics_raw_data;
GRANT CREATE VIEW ON SCHEMA google_analytics_raw_data_dest_db.google_analytics_raw_data_dest_schema TO APPLICATION snowflake_connector_for_google_analytics_raw_data;
    Copy

Provisionamento do conector

  1. Chame o procedimento PROVISION_CONNECTOR.

    Passe o nome do warehouse, do banco de dados e do esquema de destino e da função do proprietário dos dados. Esses valores diferenciam maiúsculas de minúsculas.

    CALL PROVISION_CONNECTOR(
    'GOOGLE_ANALYTICS_RAW_DATA_WAREHOUSE',
    'GOOGLE_ANALYTICS_RAW_DATA_DEST_DB.GOOGLE_ANALYTICS_RAW_DATA_DEST_SCHEMA',
    'GOOGLE_ANALYTICS_RAW_DATA_RESOURCES_PROVIDER'
);
    Copy

Crie objetos Snowflake necessários para conectar-se ao GCP

  1. Crie uma integração de segurança para sua conta de serviço.

    Primeiro, você precisa de um arquivo de chave da conta de serviço. Para obter detalhes sobre como criar um, consulte Configuração da autenticação da conta de serviço para Google Cloud Platform (GCP)

    CREATE SECURITY INTEGRATION
snowflake_connector_for_google_analytics_raw_data_security_integration
type = api_authentication
auth_type = oauth2
oauth_client_id = '<value of client_id from the JSON key file>'
oauth_token_endpoint = 'https://oauth2.googleapis.com/token'
enabled = true
oauth_allowed_scopes = (
    'https://www.googleapis.com/auth/bigquery.readonly',
    'https://www.googleapis.com/auth/cloudplatformprojects.readonly'
)
oauth_assertion_issuer = '<value of client_email from the JSON key file>'
oauth_grant='JWT_BEARER'
oauth_client_secret = '<value of private_key from the JSON key file with no delimiters or newlines>';
    Copy

  2. Crie um segredo usando a integração de segurança.

    CREATE DATABASE google_analytics_raw_data_connector_secret;
CREATE SCHEMA google_analytics_raw_data_connector_secret.oauth;

USE SCHEMA google_analytics_raw_data_connector_secret.oauth;

CREATE OR REPLACE SECRET google_analytics_raw_data
type = oauth2
api_authentication = snowflake_connector_for_google_analytics_raw_data_security_integration;
    Copy

  3. Forneça concessões relacionadas a segredos ao aplicativo do conector.

    GRANT USAGE ON DATABASE google_analytics_raw_data_connector_secret TO APPLICATION snowflake_connector_for_google_analytics_raw_data;
GRANT USAGE ON SCHEMA google_analytics_raw_data_connector_secret.oauth TO APPLICATION snowflake_connector_for_google_analytics_raw_data;
GRANT READ ON SECRET google_analytics_raw_data_connector_secret.oauth.google_analytics_raw_data TO APPLICATION snowflake_connector_for_google_analytics_raw_data;
    Copy

  4. Configure o acesso externo.

    Lembre-se de que o caminho para o segredo passado para allowed_authentication_secrets diferencia maiúsculas de minúsculas.

    USE SCHEMA google_analytics_raw_data_connector_secret.oauth;

CREATE NETWORK RULE
google_analytics_raw_data_allow_rule
mode = EGRESS
type = HOST_PORT
value_list = (
    'www.googleapis.com',
    'bigquery.googleapis.com',
    'bigquerystorage.googleapis.com',
    'cloudresourcemanager.googleapis.com',
    'oauth2.googleapis.com'
);

CREATE EXTERNAL ACCESS INTEGRATION
google_analytics_raw_data_external_access_integration
allowed_network_rules = (google_analytics_raw_data_allow_rule)
allowed_authentication_secrets = ('GOOGLE_ANALYTICS_RAW_DATA_CONNECTOR_SECRET.OAUTH.GOOGLE_ANALYTICS_RAW_DATA')
enabled = true;

GRANT USAGE ON INTEGRATION google_analytics_raw_data_external_access_integration TO APPLICATION snowflake_connector_for_google_analytics_raw_data;
    Copy

Configuração da conexão com o GCP

  1. Chame o procedimento CONFIGURE_CONNECTION.

    Passe o nome da integração de acesso externo e o caminho completo para o segredo. Esses valores diferenciam maiúsculas de minúsculas.

    CALL CONFIGURE_CONNECTION(
    'GOOGLE_ANALYTICS_RAW_DATA_EXTERNAL_ACCESS_INTEGRATION',
    'GOOGLE_ANALYTICS_RAW_DATA_CONNECTOR_SECRET.OAUTH.GOOGLE_ANALYTICS_RAW_DATA'
);
    Copy

  2. Verifique o status da conexão.

    CALL CONNECTION_STATUS();
    Copy

    Se não houver erros, você pode seguir Configuração da ingestão de dados para seu Snowflake Connector for Google Analytics Raw Data para ativar suas propriedades do Google Analytics.

Linguagem: Português