Installation et configuration du Snowflake Connector for Google Analytics Raw Data

Ce chapitre fournit des informations sur l’installation et la configuration du Snowflake Connector for Google Analytics Raw Data via Snowsight.

Installation de l”Snowflake Connector for Google Analytics Raw Data

Pour installer le connecteur, procédez comme suit :

  1. Connectez-vous à Snowsight en tant qu’utilisateur ayant le rôle ACCOUNTADMIN.

  2. Dans le menu de navigation, sélectionnez Data Products » Marketplace.

  3. Recherchez le Snowflake Connector for Google Analytics Raw Data, puis sélectionnez la vignette du connecteur.

  4. Dans la page Snowflake Connector for Google Analytics Raw Data, sélectionnez Get.

    Une boîte de dialogue s’affiche pour lancer la partie initiale du processus d’installation.

    Dans la boîte de dialogue, configurez les éléments suivants :

    1. Dans le champ Options->Application name, saisissez la base de données à utiliser comme base de données pour l’instance de connecteur. Cette base de données est créée automatiquement pour vous.

    2. Dans le champ Warehouse used for installation sélectionnez l’entrepôt que vous souhaitez utiliser pour installer le connecteur.

      Note

      Il ne s’agit pas du même entrepôt que celui utilisé par le connecteur pour synchroniser les données de Google Analytics. Dans une étape ultérieure, vous créerez un entrepôt distinct à cette fin.

    3. Sélectionnez Get.

  5. Sélectionnez Open.

    La boîte de dialogue se ferme et la page Snowflake Connector for Google Analytics Raw Data affiche les UI de configuration et de gestion du connecteur.

Configuration du Snowflake Connector for Google Analytics Raw Data

Pour configurer le connecteur, procédez comme suit :

  1. Connectez-vous à Snowsight en tant qu’utilisateur ayant le rôle ACCOUNTADMIN.

  2. Dans le menu de navigation, sélectionnez Data Products » Apps.

  3. Sélectionnez Snowflake Connector for Google Analytics Raw Data.

    L’assistant de configuration démarre.

  4. Conditions préalables

    1. Assurez-vous que toutes les conditions préalables de la liste sont remplies et marquez-les comme telles.

    2. Cliquez sur Start configuration

  5. Configuration de l’entrepôt, de la base de données, du schéma et du rôle

    Note

    Par défaut, les champs sont définis sur les noms des objets créés lors de la configuration du connecteur. Snowflake recommande d’utiliser de nouveaux objets pour ces champs. Cependant, vous pouvez spécifier les noms des objets existants, si nécessaire (par exemple, si vous réinstallez le connecteur).

    Renseignez les champs suivants et sélectionnez Configure au bas de l’écran :

    Champ

    Description

    Warehouse

    Saisissez l’identificateur d’un nouvel entrepôt virtuel dédié au connecteur ou sélectionnez-en un existant.

    Indiquez un nom unique pour votre compte. Le nom de l’entrepôt doit être un identificateur d’objet valide.

    Note

    Ne spécifiez pas le même entrepôt que celui que vous avez sélectionné au début de l’installation du connecteur.

    Le processus de configuration crée un nouvel entrepôt X-Small avec le nom spécifié.

    Vous pouvez également sélectionner un entrepôt existant.

    Destination Database

    Identificateur d’une nouvelle base de données qui contiendra le schéma avec les tables des données Google Analytics dans Snowflake. Les données téléchargées de Google Analytics atterriront ici.

    Indiquez un nom unique pour votre compte. Le nom de la base de données doit être un identificateur d’objet valide.

    Le processus de configuration crée une nouvelle base de données avec le nom spécifié.

    Vous pouvez également sélectionner une base de données existante.

    Destination Schema

    Identificateur d’un nouveau schéma qui contiendra les données Google Analytics dans Snowflake.

    Le Snowflake Connector for Google Analytics Raw Data ingère les données de Google Analytics dans les tables de ce schéma.

    Le nom du schéma doit être un identificateur d’objet valide.

    Le processus de configuration crée un nouveau schéma avec le nom spécifié.

    Vous pouvez également sélectionner un schéma existant.

    Role

    Identificateur d’un nouveau rôle personnalisé pour le connecteur.

    Indiquez un nom unique pour votre compte. Le nom du rôle doit être un identificateur d’objet valide.

    Le rôle est un rôle au niveau du compte qui aura un accès en lecture aux données ingérées.

    Vous pouvez également sélectionner un rôle existant.

    Le processus de configuration peut prendre un certain temps. Lorsque le processus de configuration se termine correctement, l’assistant de configuration passe à l’étape Authentification.

  6. Configuration de l’authentification

    Les Snowflake Connector for Google Analytics Raw Data prennent en charge deux méthodes d’authentification - OAuth et Comptes de service. Chacune des méthodes nécessite une configuration supplémentaire dans votre projet GCP.

    Pour plus d’informations sur la configuration de chaque authentification, voir :

    Si vous utilisez la méthode d’authentification Compte de service, fournissez un fichier JSON avec les identifiants de connexion du compte de service.

    Vous pouvez également renseigner les champs suivants :

    Champ

    Description

    Client email

    E-mail du compte de service Google généré lors du processus de création du compte de service dans le projet Google Cloud Platform.

    Private key

    Clé privée générée lors du processus de création du compte de service dans le projet Google Cloud Platform.

    Assurez-vous d’avoir supprimé les symboles —–BEGIN PRIVATE KEY—–, —–END PRIVATE KEY—– et \n.

    Si vous utilisez la méthode d’authentification Oauth2, renseignez les champs suivants :

    Champ

    Description

    Client id

    ID du client généré dans le projet Google Cloud Platform.

    Client secret

    ID du secret du client généré dans le projet Google Cloud Platform.

    Sélectionnez Connect

    Si vous avez sélectionné l’authentification Oauth2, la boîte de dialogue d’authentification OAuth2 Google s’affichera.

    Dans la boîte de dialogue, connectez-vous à Google pour compléter le flux d’authentification OAuth2 Google.

    Le processus d’authentification peut prendre un certain temps.

  7. Validation de la source

Une fois la connexion établie, le connecteur vérifie qu’il peut accéder aux données de Google Analytics. En cas d’erreur, le connecteur vous guidera en vous fournissant des instructions supplémentaires.

Si le processus se termine correctement, vous pouvez commencer à configurer l’ingestion. Pour plus d’informations, voir Configuration de l’ingestion de données pour votre Snowflake Connector for Google Analytics Raw Data.

Configuration du Snowflake Connector for Google Analytics Raw Data à l’aide d’instructions SQL

Pour configurer le connecteur à l’aide d’instructions SQL, procédez comme suit :

Note

Afin de provisionner le connecteur et de configurer la connexion, vous devrez utiliser des procédures stockées qui sont définies dans le schéma PUBLIC de la base de données qui sert d’instance de la base de données d’installation du connecteur.

Avant d’appeler ces procédures stockées, sélectionnez cette base de données comme base de données à utiliser pour la session.

Par exemple, si la base de données s’appelle snowflake_connector_for_google_analytics_raw_data, exécutez la commande suivante :

USE DATABASE snowflake_connector_for_google_analytics_raw_data;
Copy

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 l’entrepôt spécifié et d’exécuter des tâches.

    USE ROLE accountadmin;
CREATE WAREHOUSE google_analytics_raw_data_warehouse with warehouse_size = 'X-Small';
GRANT USAGE ON WAREHOUSE google_analytics_raw_data_warehouse TO APPLICATION snowflake_connector_for_google_analytics_raw_data;
GRANT EXECUTE TASK ON ACCOUNT TO APPLICATION snowflake_connector_for_google_analytics_raw_data;
    Copy

  2. Créez le rôle de propriétaire de données.

    USE ROLE accountadmin;
CREATE OR REPLACE ROLE google_analytics_raw_data_resources_provider;
GRANT CREATE DATABASE ON ACCOUNT TO ROLE google_analytics_raw_data_resources_provider;
GRANT USAGE ON WAREHOUSE google_analytics_raw_data_warehouse TO ROLE google_analytics_raw_data_resources_provider;
GRANT ROLE google_analytics_raw_data_resources_provider TO USER ADMIN;
    Copy

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

    Vous pouvez également utiliser une base de données et un schéma de destination existants, en particulier si vous réinstallez le connecteur.

    USE ROLE google_analytics_raw_data_resources_provider;
CREATE DATABASE google_analytics_raw_data_dest_db;
CREATE SCHEMA google_analytics_raw_data_dest_db.google_analytics_raw_data_dest_schema;
    Copy

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

    USE ROLE accountadmin;
GRANT USAGE ON DATABASE google_analytics_raw_data_dest_db TO APPLICATION snowflake_connector_for_google_analytics_raw_data;
GRANT USAGE ON SCHEMA google_analytics_raw_data_dest_db.google_analytics_raw_data_dest_schema TO APPLICATION snowflake_connector_for_google_analytics_raw_data;

GRANT CREATE TABLE ON SCHEMA google_analytics_raw_data_dest_db.google_analytics_raw_data_dest_schema TO APPLICATION snowflake_connector_for_google_analytics_raw_data;
GRANT CREATE VIEW ON SCHEMA google_analytics_raw_data_dest_db.google_analytics_raw_data_dest_schema TO APPLICATION snowflake_connector_for_google_analytics_raw_data;
    Copy

Provisionnement du connecteur

  1. Appelez la procédure PROVISION_CONNECTOR.

    Indiquez le nom de l’entrepôt, de la base de données et du schéma de destination ainsi que du rôle de propriétaire de données. Ces valeurs sont sensibles à la casse.

    CALL PROVISION_CONNECTOR(
    'GOOGLE_ANALYTICS_RAW_DATA_WAREHOUSE',
    'GOOGLE_ANALYTICS_RAW_DATA_DEST_DB.GOOGLE_ANALYTICS_RAW_DATA_DEST_SCHEMA',
    'GOOGLE_ANALYTICS_RAW_DATA_RESOURCES_PROVIDER'
);
    Copy

Créez les objets Snowflake nécessaires à la connexion au GCP.

  1. Créez une intégration de sécurité pour votre compte de service.

    Tout d’abord, vous avez besoin d’un fichier de clé de compte de service. Pour des informations détaillées sur sa création, voir Configuration de l’authentification du compte de service de Google Cloud Platform (GCP)

    CREATE SECURITY INTEGRATION
snowflake_connector_for_google_analytics_raw_data_security_integration
type = api_authentication
auth_type = oauth2
oauth_client_id = '<value of client_id from the JSON key file>'
oauth_token_endpoint = 'https://oauth2.googleapis.com/token'
enabled = true
oauth_allowed_scopes = (
    'https://www.googleapis.com/auth/bigquery.readonly',
    'https://www.googleapis.com/auth/cloudplatformprojects.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

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

    CREATE DATABASE google_analytics_raw_data_connector_secret;
CREATE SCHEMA google_analytics_raw_data_connector_secret.oauth;

USE SCHEMA google_analytics_raw_data_connector_secret.oauth;

CREATE OR REPLACE SECRET google_analytics_raw_data
type = oauth2
api_authentication = snowflake_connector_for_google_analytics_raw_data_security_integration;
    Copy

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

    GRANT USAGE ON DATABASE google_analytics_raw_data_connector_secret TO APPLICATION snowflake_connector_for_google_analytics_raw_data;
GRANT USAGE ON SCHEMA google_analytics_raw_data_connector_secret.oauth TO APPLICATION snowflake_connector_for_google_analytics_raw_data;
GRANT READ ON SECRET google_analytics_raw_data_connector_secret.oauth.google_analytics_raw_data TO APPLICATION snowflake_connector_for_google_analytics_raw_data;
    Copy

  4. Configurez l’accès externe.

    N’oubliez pas que le chemin d’accès au secret transmis à allowed_authentication_secrets est sensible à la casse.

    USE SCHEMA google_analytics_raw_data_connector_secret.oauth;

CREATE NETWORK RULE
google_analytics_raw_data_allow_rule
mode = EGRESS
type = HOST_PORT
value_list = (
    'www.googleapis.com',
    'bigquery.googleapis.com',
    'bigquerystorage.googleapis.com',
    'cloudresourcemanager.googleapis.com',
    'oauth2.googleapis.com'
);

CREATE EXTERNAL ACCESS INTEGRATION
google_analytics_raw_data_external_access_integration
allowed_network_rules = (google_analytics_raw_data_allow_rule)
allowed_authentication_secrets = ('GOOGLE_ANALYTICS_RAW_DATA_CONNECTOR_SECRET.OAUTH.GOOGLE_ANALYTICS_RAW_DATA')
enabled = true;

GRANT USAGE ON INTEGRATION google_analytics_raw_data_external_access_integration TO APPLICATION snowflake_connector_for_google_analytics_raw_data;
    Copy

Configuration de la connexion au GCP

  1. Appelez la procédure CONFIGURE_CONNECTION.

    Transmettez le nom de l’intégration de l’accès externe et le chemin d’accès complet au secret. Ces valeurs sont sensibles à la casse.

    CALL CONFIGURE_CONNECTION(
    'GOOGLE_ANALYTICS_RAW_DATA_EXTERNAL_ACCESS_INTEGRATION',
    'GOOGLE_ANALYTICS_RAW_DATA_CONNECTOR_SECRET.OAUTH.GOOGLE_ANALYTICS_RAW_DATA'
);
    Copy

  2. Vérifiez le statut de la connexion.

    CALL CONNECTION_STATUS();
    Copy

    S’il n’y a pas d’erreurs, vous pouvez suivre la procédure Configuration de l’ingestion de données pour votre Snowflake Connector for Google Analytics Raw Data pour activer vos propriétés Google Analytics.

Langage: Français