Gerenciamento do Snowflake Connector for Google Analytics Raw Data¶

Alteração do intervalo de ingestão do conector¶

O conector verifica e baixa periodicamente os dados de BigQuery. A verificação é feita a cada 8 horas por padrão, mas pode ser alterada. Se você deseja definir o novo intervalo para verificação e download de dados, use o procedimento CONFIGURE_INGESTION_INTERVAL definido no esquema PUBLIC:

CALL CONFIGURE_INGESTION_INTERVAL(<interval_configuration_name>)

Possíveis configurações de intervalo juntamente com definições de cron que são usadas em segundo plano:

EVERY_15_MINUTES   -   */15 * * * * UTC
EVERY_30_MINUTES   -   */30 * * * * UTC
EVERY_1_HOUR       -   0 * * * * UTC
EVERY_4_HOURS      -   0 3/4 * * * UTC
EVERY_8_HOURS      -   0 3/8 * * * UTC
EVERY_1_DAY        -   0 3 * * * UTC

Exemplo de uso:

CALL CONFIGURE_INGESTION_INTERVAL('EVERY_1_HOUR')

A lista de intervalos compatíveis também pode ser impressa usando o procedimento LIST_SUPPORTED_INGESTION_INTERVALS definido no esquema PUBLIC:

CALL LIST_SUPPORTED_INGESTION_INTERVALS()

Configuração de alertas¶

Para configurar alertas, 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, vá para a seção Settings e selecione Email alerts no menu à esquerda.

   Isso exibe uma página para a configuração de alertas por e-mail.

5. No campo Email Address, forneça um endereço de e-mail verificado pelo Snowflake.

1. No campo Email Frequency, selecione com que frequência você gostaria de receber alertas:

• Immediately - você receberá notificações de acordo com os valores definidos na sincronização de tabelas.

• Once per day - você receberá notificações uma vez por dia às 12PM UTC.

1. Selecione Save changes para começar a receber alertas por e-mail.

Atualização do conector¶

As atualizações do conector são gerenciadas automaticamente pelo provedor do aplicativo.

Escalonamento do conector¶

Você deve começar seu trabalho com o conector usando um X-Small, pois provavelmente proporcionará um desempenho suficiente. No entanto, se estiver enfrentando alguma lentidão do conector, você pode tentar aumentar gradualmente o tamanho do warehouse e avaliar se há algum aumento de desempenho em cada etapa. Se o conector vai ganhar alguma coisa com o dimensionamento do warehouse dependerá de alguns fatores, como o número de propriedades ou a quantidade de dados que cada uma delas possui.

Para obter informações sobre como redimensionar o warehouse, consulte Redimensionamento de um warehouse em Como trabalhar com warehouses.

Alteração do warehouse para o conector¶

É possível alterar o warehouse que o Snowflake Connector for Google Analytics Raw Data utiliza para suas tarefas internas sem reinstalar o conector. Primeiro, certifique-se de que o conector esteja pausado. Isso pode ser feito tanto via UI ou usando o procedimento PAUSE_CONNECTOR. Em seguida, você precisa conceder ao conector acesso ao novo warehouse:

GRANT USAGE ON WAREHOUSE <new_warehouse_name> TO APPLICATION snowflake_connector_for_google_analytics_raw_data;

Após o acesso ser concedido, execute o procedimento UPDATE_WAREHOUSE definido no esquema PUBLIC:

CALL UPDATE_WAREHOUSE('<new_warehouse_name');

Reautenticação do conector¶

Para alterar o segredo, a integração de acesso externo ou a integração de segurança usada pelo conector sem reinstalação, você precisa executar o procedimento UPDATE_CONNECTION definido no esquema PUBLIC. Certifique-se de que todos os novos objetos sejam definidos conforme descrito em Configuração do Snowflake Connector for Google Analytics Raw Data usando SQL e que o conector tenha todas as concessões necessárias.

CALL UPDATE_CONNECTION('<new external access integration>', '<new secret>', '<new security integration>');

Desativação automática de propriedades inacessíveis do Google Analytics¶

O conector possui um mecanismo para desativar automaticamente propriedades inacessíveis do Google Analytics, a fim de evitar custos desnecessários causados por tentativas de ingestão de dados que não existem indefinidamente e alertar você de que os dados não estão mais sendo ingeridos. A propriedade é considerada inacessível e poderá ser desativada automaticamente se a ingestão de dados tiver falhado nos últimos 7 dias.

Como proceder durante a recuperação de desastres e failover¶

Se quiser garantir que o conector poderá continuar a ingestão de dados durante uma interrupção de implantação, será necessário configurar o sink database failover para uma conta de réplica. Para obter mais detalhes, consulte Execução de failover em bancos de dados em múltiplas contas.

Além disso, após uma interrupção, você precisará instalar manualmente o Snowflake Connector for Google Analytics Raw Data na sua conta de réplica, pois o conector em si não pode ser replicado. Após a instalação, ele será sincronizado com o banco de dados do coletor replicado.

Quando ocorre uma interrupção na implantação e o banco de dados coletor faz failover para uma conta de réplica, execute as seguintes etapas:

1. Faça login na sua conta secundária, onde o banco de dados do coletor é replicado.

2. Instale o Snowflake Connector for Google Analytics Raw Data na sua conta secundária. O conector se sincronizará com o banco de dados do coletor replicado. A instância da sua conta principal entra em estado somente leitura após uma interrupção, portanto, os dados não serão corrompidos neste momento.

3. Se quiser voltar para a conta principal depois que a implantação estiver disponível novamente, primeiro você precisará descartar ambos os conectores. É necessário garantir um estado consistente do conector.

4. Replique os dados da conta secundária para a principal usando o mecanismo de replicação.

5. Reinstale o conector em uma conta primária assim que os dados na tabela de coletores forem sincronizados com a tabela de coletores em sua conta secundária.

Atualização de opções de ingestão de dados¶

É possível usar o procedimento UPDATE_INGESTION_OPTIONS definido no esquema PUBLIC para modificar opções de ingestão padrão para determinadas propriedades. Este procedimento permite que você altere o seguinte:

• EXCLUDE_NULLS – Remove campos com valores nulo dos dados ingeridos. Definir esse valor como TRUE pode melhorar o rendimento da ingestão de dados. O valor padrão é FALSE.

• DISABLE_AUTO_RELOADS – Desativa o recarregamento automático de dados. 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.

CALL UPDATE_INGESTION_OPTIONS(
    PROPERTY_IDS => ['<property_1>', '<property_2>'],
    EXCLUDE_NULLS => <boolean>,
 );

Atualização de visualizações niveladas sob demanda¶

É possível usar o procedimento REFRESH_VIEWS definido no esquema PUBLIC para acionar uma atualização sob demanda das exibições niveladas. As exibições niveladas são atualizadas automaticamente todos os dias por padrão. Para obter mais detalhes sobre as exibições, consulte Acesso aos dados ingeridos por Snowflake Connector for Google Analytics Raw Data.

CALL REFRESH_VIEWS();