Configuração da ingestão de dados para seu Snowflake Connector for Google Analytics Raw Data¶

Modificação da ingestão de dados usando o Snowsight¶

Para modificar as tabelas do Google Analytics a serem ingeridas ou o cronograma de sincronização para as tabelas, 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. 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, navegue até a seção Data Sync.

5. Selecione Edit properties.

6. Modifique as tabelas que você deseja ingerir:

   1. Procure a tabela que você deseja ingerir.

   2. Selecione a caixa de seleção na coluna Status ao lado da tabela que você deseja selecionar ou desmarcar.

7. Selecione Update data sync.

Listagem das propriedades disponíveis para ingestão¶

Para listar todas as propriedades disponíveis em um determinado projeto GCP, chame o seguinte procedimento armazenado:

CALL LIST_GA_PROPERTIES();

Copy

O resultado exibe todos os projetos e propriedades disponíveis para ingestão por uma conta autorizada. Se nenhum resultado for retornado, verifique:

• Se a exportação de dados do Google Analytics para BigQuery está configurada.

• Se os dados exportados estão visíveis no BigQuery.

• Se as funções adequadas forem atribuídas à conta de serviço/usuário autenticado usado.

Informamos que pode levar até 24 horas entre a configuração da exportação de dados e o armazenamento dos dados no BigQuery. Esse atraso pode ser a causa do procedimento LIST_GA_PROPERTIES não produzir resultados.

Desativar a exportação do Google Analytics não significa que a propriedade foi omitida por LIST_GA_PROPERTIES. Mesmo que a exportação tenha sido desativada, os dados ainda podem persistir no BigQuery e podem ser sincronizados pelo conector.

Preparação do banco de dados de destino¶

Antes de ativar a ingestão, é necessário conceder ao conector acesso para criar tabelas e exibições dentro do banco de dados e do esquema de destino.

GRANT USAGE ON DATABASE <destination database> TO APPLICATION <application name>;

GRANT USAGE ON SCHEMA <destination database>.<destination schema> TO APPLICATION <application name>;

GRANT CREATE TABLE ON SCHEMA <destination database>.<destination schema> TO APPLICATION <application name>;

GRANT CREATE VIEW ON SCHEMA <destination database>.<destination schema> TO APPLICATION <application name>;

Copy

Ativação ou desativação da ingestão de uma propriedade¶

Para ativar ou desativar a sincronização de dados para uma propriedade específica no Google Analytics, chame o procedimento armazenado ENABLE_PROPERTIES com os seguintes argumentos:

CALL ENABLE_PROPERTIES('<gcp_project>', ['<properties_to_configure>'], <enable_initial_load>, <exclude_nulls>, <disable_auto_reloads>);

Copy

Onde:

gcp_project

Especifica o projeto GCP das propriedades ativadas.

properties_to_configure

Especifica uma lista delimitada por vírgulas de nomes de propriedades do Google Analytics entre aspas simples.

Use o nome da propriedade sem o prefixo analytics_.

enable_initial_load

Um booleano que indica se o carregamento de dados inicial deve ser habilitado ou desabilitado, que ingere todos os dados históricos de uma propriedade e depois prossegue para a sincronização atual.

Este é um argumento opcional e o valor padrão é true.

Se uma propriedade tiver sido habilitada anteriormente, esse sinalizador será ignorado e a ingestão continuará do ponto em que parou quando a propriedade foi desabilitada.

exclude_nulls

Booliano opcional que indica se campos com valores nulos devem ser excluídos dos dados ingeridos. Definir esse parâmetro como true pode melhorar a taxa de transferência da ingestão de dados. O valor padrão é false.

disable_auto_reloads

Um booliano opcional que indica se as recargas automáticas devem ser desabilitadas. Para mais detalhes sobre recarga automática, consulte Modelo de ingestão de dados para o Snowflake Connector for Google Analytics Raw Data. Definir esse valor como true pode reduzir o consumo de crédito, mas dados atrasados não serão ingeridos no Snowflake. O valor padrão é false.

Por exemplo, para permitir a sincronização das propriedades chamadas property1, property2 e property3 no projeto gcp_example_project, execute o seguinte comando:

CALL ENABLE_PROPERTIES('gcp_example_project', ['property1','property2','property3']);

Copy

Para habilitar propriedades sem o carregamento inicial de dados, use uma consulta ENABLE_PROPERITES semelhante a:

CALL ENABLE_PROPERTIES('gcp_example_project', ['property1','property2','property3'], false);

Copy

É possível usar argumentos nomeados para especificar argumentos específicos e deixar o restante inalterado. Por exemplo, para habilitar as propriedades com o carregamento inicial e excluir campos que contenham valores nulo, execute a seguinte consulta:

 CALL ENABLE_PROPERTIES(
    PROJECT_ID => 'gcp_example_project',
    PROPERTY_IDS => ['property1', 'property2', 'property3'],
    INITIAL_LOAD => TRUE,
    EXCLUDE_NULLS => TRUE
);

Copy

Para evitar que essas propriedades sejam ingeridas, execute o seguinte comando:

CALL DISABLE_PROPERTIES('gcp_example_project', ['property1','property2','property3']);

Copy

Desativar a propriedade interrompe sua sincronização. Quando a sincronização de propriedades é desabilitada, toda a ingestão iniciada, mas ainda não concluída, é removida do banco de dados de destino.

O procedimento ENABLE_PROPERTIES adiciona os nomes das propriedades especificadas à exibição ENABLED_PROPERTIES.