Configuration de Snowflake Connector for Google Analytics Aggregate Data via SQL¶

Préparation d’un entrepôt, d’un rôle de propriétaire de données et d’une base de données de destination¶

1. Accordez à l’application du connecteur le droit d’utiliser un entrepôt spécifié et d’exécuter des tâches :

   USE ROLE accountadmin;
   CREATE WAREHOUSE google_analytics_aggregate_data_warehouse WITH WAREHOUSE_SIZE = 'X-Small';
   GRANT USAGE ON WAREHOUSE google_analytics_aggregate_data_warehouse TO APPLICATION snowflake_connector_for_google_analytics_aggregate_data;
   GRANT EXECUTE TASK, EXECUTE MANAGED TASK ON ACCOUNT TO APPLICATION snowflake_connector_for_google_analytics_aggregate_data;
   

   Copy

   Le connecteur a besoin de ces droits pour pouvoir procéder à l’ingestion.

2. Créez une base de données et un schéma de destination :

   CREATE DATABASE google_analytics_aggregate_data_dest_db;
   CREATE SCHEMA google_analytics_aggregate_data_dest_db.google_analytics_aggregate_data_dest_schema;
   

   Copy

   Les données ingérées sont stockées dans le schéma de destination. Vous pouvez également utiliser une base de données et un schéma existants.

3. Ajoutez à l’application les droits nécessaires sur la base de données de destination :

   USE ROLE accountadmin;
   GRANT USAGE ON DATABASE google_analytics_aggregate_data_dest_db TO APPLICATION snowflake_connector_for_google_analytics_aggregate_data;
   GRANT USAGE ON SCHEMA google_analytics_aggregate_data_dest_db.google_analytics_aggregate_data_dest_schema TO APPLICATION snowflake_connector_for_google_analytics_aggregate_data;
   GRANT CREATE TABLE ON SCHEMA google_analytics_aggregate_data_dest_db.google_analytics_aggregate_data_dest_schema TO APPLICATION snowflake_connector_for_google_analytics_aggregate_data;
   GRANT CREATE VIEW ON SCHEMA google_analytics_aggregate_data_dest_db.google_analytics_aggregate_data_dest_schema TO APPLICATION snowflake_connector_for_google_analytics_aggregate_data;
   

   Copy

   L’application a besoin des droits pour pouvoir créer des tables pour les données des rapports et pour pouvoir créer les vues des rapports.

4. Créez le rôle de propriétaire de données et ajoutez les droits nécessaires :

   USE ROLE accountadmin;
   CREATE OR REPLACE ROLE google_analytics_aggregate_data_resources_provider;
   GRANT USAGE ON DATABASE google_analytics_aggregate_data_dest_db TO ROLE google_analytics_aggregate_data_resources_provider;
   GRANT USAGE ON SCHEMA google_analytics_aggregate_data_dest_db.google_analytics_aggregate_data_dest_schema TO ROLE google_analytics_aggregate_data_resources_provider;
   GRANT USAGE ON WAREHOUSE google_analytics_aggregate_data_warehouse TO ROLE google_analytics_aggregate_data_resources_provider;
   GRANT APPLICATION ROLE snowflake_connector_for_google_analytics_aggregate_data.data_reader TO ROLE google_analytics_aggregate_data_resources_provider;
   

   Copy

Configuration du connecteur¶

• Appelez la procédure CONFIGURE_CONNECTOR, en transmettant le nom de l’entrepôt, la base de données et le schéma de destination et le rôle de propriétaire de données :

  USE ROLE accountadmin;
  CALL CONFIGURE_CONNECTOR(
     PARSE_JSON('{"warehouse": "GOOGLE_ANALYTICS_AGGREGATE_DATA_WAREHOUSE", "destination_database": "GOOGLE_ANALYTICS_AGGREGATE_DATA_DEST_DB", "destination_schema": "GOOGLE_ANALYTICS_AGGREGATE_DATA_DEST_SCHEMA", "data_owner_role": "GOOGLE_ANALYTICS_AGGREGATE_DATA_RESOURCES_PROVIDER"}')
  );
  

  Copy

  Note

  Les valeurs transmises à CONFIGURE_CONNECTOR sont sensibles à la casse et doivent être transmises telles qu’elles apparaissent dans l’UI (par exemple, telles qu’elles apparaissent dans la commande SHOW).

Créer les objets Snowflake nécessaires à la connexion à GA4¶

1. Pour créer une intégration de sécurité pour votre connexion, suivez l’une des options suivantes :

   Note

   Il est recommandé d’utiliser un compte de service.

   Si vous utilisez un compte de service, vous avez besoin d’un fichier de clé. Pour des informations détaillées sur sa création, voir Configurer l’authentification du compte de service de Google Cloud. Créez une intégration de sécurité en utilisant les détails du fichier de clé :

   CREATE SECURITY INTEGRATION
   snowflake_connector_for_google_analytics_aggregate_data_security_integration
   type = api_authentication
   auth_type = oauth2
   oauth_client_id = '000000000000000000000'
   oauth_token_endpoint = 'https://oauth2.googleapis.com/token'
   enabled = true
   oauth_allowed_scopes = ('https://www.googleapis.com/auth/analytics.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

   Si vous utilisez OAuth2, vous devez configurer un écran de consentement et les identifiants de connexion du client. Pour des informations détaillées sur la manière de procéder, voir Configurer l’authentification OAuth pour Google Cloud. Vous devez ensuite créer l’intégration de sécurité :

   CREATE OR REPLACE SECURITY INTEGRATION
   snowflake_connector_for_google_analytics_aggregate_data_security_integration
   type = api_authentication
   auth_type = oauth2
   oauth_client_id = '<value of gcp oauth client_id>'
   oauth_client_secret = '<value of gcp oauth secret>'
   oauth_token_endpoint = 'https://oauth2.googleapis.com/token'
   OAUTH_AUTHORIZATION_ENDPOINT = 'https://accounts.google.com/o/oauth2/auth?access_type=offline&prompt=consent'
   OAUTH_ALLOWED_SCOPES = ('https://www.googleapis.com/auth/analytics.readonly')
   enabled = true;
   

   Copy

2. Créez un secret à l’aide de l’intégration de sécurité :

   USE ROLE accountadmin;
   
   CREATE DATABASE connectors_secret;
   CREATE SCHEMA connectors_secret.snowflake_connector_for_google_analytics_aggregate_data;
   
   USE SCHEMA connectors_secret.snowflake_connector_for_google_analytics_aggregate_data;
   
   CREATE OR REPLACE SECRET secret
   type = oauth2
   api_authentication = snowflake_connector_for_google_analytics_aggregate_data_security_integration;
   

   Copy

   Note

   Le secret stockera en toute sécurité le jeton d’accès généré à l’aide des identifiants de connexion de l’intégration de sécurité.

3. Accordez à l’application du connecteur les droits associés au secret :

   USE ROLE accountadmin;
   
   GRANT USAGE ON DATABASE connectors_secret TO APPLICATION snowflake_connector_for_google_analytics_aggregate_data;
   GRANT USAGE ON SCHEMA connectors_secret.snowflake_connector_for_google_analytics_aggregate_data TO APPLICATION snowflake_connector_for_google_analytics_aggregate_data;
   GRANT READ ON SECRET connectors_secret.snowflake_connector_for_google_analytics_aggregate_data.secret TO APPLICATION snowflake_connector_for_google_analytics_aggregate_data;
   

   Copy

4. Si vous utilisez l’autorisation oauth2, générez un jeton. Utilisez le lien généré par le code suivant :

   SELECT SYSTEM$START_OAUTH_FLOW('connectors_secret.snowflake_connector_for_google_analytics_aggregate_data.secret');
   

   Copy

   Vous serez redirigé(e) vers l’écran oauth2. Après avoir accepté les droits requis, vous serez redirigé(e) vers le point de terminaison, ce qui termine le flux oauth2.

5. Configurez l’accès externe :

   USE ROLE accountadmin;
   
   USE SCHEMA connectors_secret.snowflake_connector_for_google_analytics_aggregate_data;
   
   CREATE NETWORK RULE network_rule
   mode = EGRESS
   type = HOST_PORT
   value_list = (
       'analyticsadmin.googleapis.com:443',
       'analyticsdata.googleapis.com:443'
   );
   
   CREATE EXTERNAL ACCESS INTEGRATION google_analytics_aggregate_data_external_access_integration
   allowed_network_rules = (connectors_secret.snowflake_connector_for_google_analytics_aggregate_data.network_rule)
   allowed_authentication_secrets = ('CONNECTORS_SECRET.OAUTH.SNOWFLAKE_CONNECTOR_FOR_GOOGLE_ANALYTICS_AGGREGATE_DATA')
   enabled = true;
   
   GRANT USAGE ON INTEGRATION snowflake_connector_for_google_analytics_aggregate_data_external_access_integration TO APPLICATION snowflake_connector_for_google_analytics_aggregate_data;
   

   Copy

   Note

   Le connecteur utilise l’intégration d’accès externe pour communiquer avec les APIs Google Analytics. La règle de réseau contrôle la liste des hôtes autorisés.

Définir la configuration de la connexion¶

• Appelez la procédure SET_CONNECTION_CONFIGURATION, en transmettant l’intégration d’accès externe, le chemin d’accès complet au secret et l’intégration de sécurité :

  USE ROLE accountadmin;
  CALL SET_CONNECTION_CONFIGURATION(
      PARSE_JSON('{"external_access_integration": "SNOWFLAKE_CONNECTOR_FOR_GOOGLE_ANALYTICS_AGGREGATE_DATA_EXTERNAL_ACCESS_INTEGRATION", "secret": "CONNECTORS_SECRET.SNOWFLAKE_CONNECTOR_FOR_GOOGLE_ANALYTICS_AGGREGATE_DATA.SECRET", "security_integration": "SNOWFLAKE_CONNECTOR_FOR_GOOGLE_ANALYTICS_AGGREGATE_DATA_SECURITY_INTEGRATION"}')
  );
  

  Copy

  Note

  Les valeurs transmises à SET_CONNECTION_CONFIGURATION doivent être des identificateurs incomplets, en majuscules.

Finaliser la configuration du connecteur¶

• Appelez la procédure FINALIZE_CONNECTOR_CONFIGURATION :

  USE ROLE accountadmin;
  CALL FINALIZE_CONNECTOR_CONFIGURATION(
       PARSE_JSON('{}')
  );
  

  Copy

Une fois le processus correctement terminé, la configuration de l’ingestion peut commencer. Pour plus d’informations, voir Configurer l’ingestion de données de votre instance Snowflake Connector for Google Analytics Aggregate Data.