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

O Snowflake Connector para Google Analytics Aggregate Data está sujeito aos Termos do conector.

Este tópico fornece diretrizes para a solução de problemas com o Snowflake Connector for Google Analytics Aggregate Data.

Como chamar o procedimento get_troubleshooting_data

O procedimento GET_TROUBLESHOOTING_DATA retorna informações sobre a configuração de um conector, o histórico de ingestão, os erros e as informações adicionais que podem ajudar a determinar a causa raiz de um problema. Este procedimento pode ser chamado no conector em qualquer estado (configurado, não configurado, em execução, pausado e assim por diante).

Nota

Para relatar um problema com o conector ao suporte Snowflake, anexe a saída deste procedimento.

GET_TROUBLESHOOTING_DATA recebe dois parâmetros: um carimbo de data/hora “de” e um carimbo de data/hora “para”. Eles limitam as linhas retornadas ao período relevante. Por exemplo, para obter dados de solução de problemas com um histórico de ingestão da última semana, você pode chamar:

CALL GET_TROUBLESHOOTING_DATA(DATEADD(day, -7, SYSDATE()), SYSDATE());
Copy

Verificação da conexão com o Google Analytics

Para verificar se o conector pode acessar os dados do Google Analytics, chame o procedimento armazenado TEST_CONNECTION, que está definido no esquema PUBLIC do banco de dados de instalação do conector:

CALL TEST_CONNECTION();
Copy

Verificação das estatísticas do conector e exibições de erros do conector

Se você encontrar problemas com a ingestão de dados, poderá marcar a exibição CONNECTOR_STATS e a exibição CONNECTOR_ERRORS do esquema PUBLIC no banco de dados de instalação do conector:

SELECT * FROM PUBLIC.CONNECTOR_STATS;
SELECT * FROM PUBLIC.CONNECTOR_ERRORS;
Copy

Para obter mais informações sobre o conteúdo retornado, consulte Monitoramento do Snowflake Connector for Google Analytics Aggregate Data.

Transferência de propriedade de tabelas e exibições no esquema de destino

O conector deve possuir todas as tabelas e exibições de relatório associadas. Se a propriedade for transferida para outra função, ela poderá ser devolvida ao conector usando a função SYSTEM$GRANT_OWNERSHIP_TO_APPLICATION.

USE ROLE accountadmin;
CALL SYSTEM$GRANT_OWNERSHIP_TO_APPLICATION(<connector_app>, true, <destination_database>, <destination_schema>);
Copy

SYSTEM$GRANT_OWNERSHIP_TO_APPLICATION é uma função de sistema fornecida pelo Snowflake que permite a transferência de propriedade de tabelas e exibições em um banco de dados ou esquema especificado para o aplicativo. Somente a propriedade de tabelas regulares e exibições comuns é transferida; a propriedade de tabelas dinâmicas, tabelas externas e exibições materializadas, por exemplo, não será transferida.

A função possui a seguinte assinatura:

SYSTEM$GRANT_OWNERSHIP_TO_APPLICATION(<to_app>, <should_copy_grants>, <from_database>, <from_schema>)
Copy

Onde:

to_app

Especifica o nome do aplicativo para o qual a propriedade dos objetos deve ser transferida.

should_copy_grants

Se TRUE, então copie as concessões existentes, caso contrário, revogue. A cópia de subsídios requer a permissão MANAGE GRANTS no chamador.

from_database

Nome do banco de dados que contém objetos cuja propriedade deve ser alterada.

from_schema

Nome do esquema que contém objetos cuja propriedade deve ser alterada (opcional). Se nenhum esquema for especificado, a propriedade será transferida em tabelas exibições em todos os esquemas no banco de dados fornecido. Objetos em esquemas gerenciados são omitidos durante a transferência de propriedade.

Para executar a função, o chamador deve atender a uma das seguintes condições:

  • Ter a permissão MANAGE GRANTS (por exemplo, função ACCOUNTADMIN ou SECURITYADMIN); ou

  • Conter a função proprietária da instância do aplicativo e a função proprietária de todos os objetos para transferir a propriedade. Os objetos cuja propriedade está ausente são omitidos pela função.

Por exemplo, para retornar a propriedade ao conector que:

  • Foi instalado como snowflake_connector_for_google_analytics_aggregate_data

  • Usa o esquema nomeado dest_db.dest_schema para os dados do Google Analytics no Snowflake

Execute o seguinte comando:

USE ROLE accountadmin;
CALL SYSTEM$GRANT_OWNERSHIP_TO_APPLICATION('snowflake_connector_for_google_analytics_aggregate_data', true, 'dest_db', 'dest_schema');
Copy