Solução de problemas do Snowflake Connector for Google Analytics Raw Data¶

Verificação de uma conexão com a instância do Google Cloud Platform (GCP)¶

Para verificar se o Snowflake Connector for Google Analytics Raw Data pode acessar a instância do Google Cloud Platform (GCP), chame o procedimento armazenado CONNECTION_STATUS, que é definido no esquema PUBLIC do banco de dados da instalação do conector:

CALL CONNECTION_STATUS();

Para verificar o status da conexão em Snowsight, 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.

A cor do ícone na seção Autenticar no Google Cloud Platform mostra se a conexão com GCP foi bem-sucedida. Se o ícone estiver vermelho, a tentativa de conexão com GCP falhou. Para tentar reconectar, selecione Reauthenticate.

Se o ícone estiver verde, o conector está pronto para ingerir dados.

Verificação do status do conector¶

Para examinar o status do conector, use o procedimento armazenado GET_CONNECTOR_STATUS, conforme mostrado:

CALL PUBLIC.GET_CONNECTOR_STATUS()

Verificação do status de ingestão atual¶

Se faltarem dados de um dia específico, você poderá consultar a exibição CONNECTOR_STATS para ver se houve algum erro ao tentar ingerir a tabela desse dia do BigQuery:

SELECT * FROM CONNECTOR_STATS WHERE PROPERTY_ID = '<property_name>' AND BIG_QUERY_TABLE = 'events_<date>' ORDER BY RUN_START_TIME DESC;

O resultado mostrará todas as tentativas de download de uma tabela específica do conjunto de dados do BigQuery para uma propriedade específica, com a mais recente no topo. A coluna STATUS mostrará o resultado e, para qualquer tentativa fracassada, a coluna ERROR_MESSAGES detalhará o que aconteceu.

Download dos logs do conector¶

Se você encontrar problemas com o conector, poderá chamar o procedimento armazenado GET_TROUBLESHOOTING_DATA, que está definido no esquema PUBLIC do banco de dados de instalação do conector:

CALL GET_TROUBLESHOOTING_DATA(7);

O parâmetro define quantos dias passados desde agora devem ser incluídos nos logs. Use 7 como padrão, a menos que o suporte solicite que você use um valor diferente.

Como resultado, você obtém os logs completos do conector. Você pode baixar os logs, filtrar e compartilhar os logs com o provedor de aplicativos.

Compartilhamento dos logs do conector de uma tabela de eventos com um provedor de aplicativos¶

É possível compartilhar logs do conector armazenados na tabela de eventos com o provedor de aplicativo. Isto poderia ser usado pelo provedor para investigar problemas encontrados com o conector. Clique neste link para ler mais sobre o Registro de ativação do consumidor.

Para ativar o compartilhamento de eventos de aplicativo da tabela de eventos, execute:

ALTER APPLICATION <GARD APPLICATION NAME> SET SHARE_EVENTS_WITH_PROVIDER = TRUE;

Para parar de compartilhar, execute:

ALTER APPLICATION <GARD APPLICATION NAME> SET SHARE_EVENTS_WITH_PROVIDER = FALSE;

O status atual pode ser verificado executando:

DESC APPLICATION <GARD APPLICATION NAME>;

Comparação das contagens de linhas no Google Cloud Platform (GCP) e no Snowflake¶

Para verificar se a ingestão estava correta, compare as contagens de linhas no Snowflake e no Google Cloud Platform (GCP).

Para verificar a contagem de linhas no Snowflake, execute a seguinte consulta:

SELECT COUNT(*) FROM analytics_<property_name> WHERE source_table_date = '<date>';

Para verificar a contagem de linhas em GCP, execute a seguinte consulta:

SELECT COUNT(*) FROM '<project_id>.analytics_<property_name>.events_<date>';