Installation et configuration du Snowflake Connector for Google Analytics Raw Data¶

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 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 avec le rôle ACCOUNTADMIN ou tout autre rôle qui répond aux exigences suivantes :

   • Vous devez disposer de ces privilèges au niveau du compte :

     • EXECUTE TASK avec option d’autorisation

     • EXECUTE MANAGED TASK avec option d’autorisation

   • EVENT_TABLE doit être activé sur le compte.

   • Pour accéder à l’entrepôt, vous devez disposer d’au moins un des privilèges suivants :

     • Le privilège CREATE WAREHOUSE sur le compte.

     • Le privilègeOWNERSHIP sur l’entrepôt

     • Le privilègeUSAGE sur l’entrepôt (avec option d’autorisation)

   • Pour accéder à la base de données, vous devez disposer d’au moins l’un des privilèges suivants :

     • Le privilège CREATE DATABASE sur le compte.

     • Le privilège OWNERSHIP sur la base de données.

     • Le privilègeUSAGE sur la base de données (avec option d’autorisation)

   • Pour accéder au schéma, vous devez disposer d’au moins un des privilèges suivants :

     • Le privilège CREATE DATABASE sur le compte.

     • Le privilège OWNERSHIP sur la base de données.

     • Le privilègeUSAGE sur la base de données (avec option d’autorisation)

     • Le privilège CREATE SCHEMA sur la base de données.

     • Les privilèges USAGE, CREATE TABLE, CREATE VIEW sur le schéma (avec option d’autorisation)

   • En option : Pour accéder aux rôles, vous pouvez créer un nouveau rôle ou sélectionner un rôle existant auquel sera attribué le rôle d’application DATA_READER. Si vous souhaitez créer un nouveau rôle, vous avez besoin des privilèges CREATE ROLE sur votre compte. Cependant, cela n’est pas nécessaire pour terminer la configuration.

2. Dans le menu de navigation, sélectionnez Catalog » 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.

   Si la base de données et le schéma de destination existants ont été fournis, les tables et les vues ordinaires existantes deviendront la propriété de Snowflake Connector for Google Analytics Raw Data. Cela exclut, par exemple, les tables externes et les vues matérialisées. En outre, rien ne sera transféré dans les schémas gérés.

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

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 :

   • Configuration de l’authentification du compte de service de Google Cloud Platform (GCP)

   • Configuration de l’authentification OAuth pour Google Cloud Platform (GCP)

   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 retiré -----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.

   Si vous n’êtes pas connecté en tant qu’utilisateur avec le rôleACCOUNTADMIN, assurez-vous de répondre aux exigences suivantes :

   • Vous devez avoir le privilègeCREATE INTEGRATION.

   • Si les intégrations ont été créées précédemment par d’autres rôles, la propriété de ces intégrations doit être transférée à votre rôle.

   • Si la base de données CONNECTORS_SECRET n’existe pas, vous avez besoin des privilèges CREATE DATABASE.

   • Si la base de données CONNECTORS_SECRET existe, mais a été créée par un autre rôle, vous devez disposer de ces privilèges :

     • USAGE WITH GRANT OPTION

     • CREATE SCHEMA WITH GRANT OPTION

   • Si le schéma CONNECTORS_SECRET.APP_NAME existe, mais a été créé par un autre rôle, vous avez besoin de ces privilèges :

     • USAGE WITH GRANT OPTION

     • CREATE SECRET

     • CREATE NETWORK RULE

   • Si CONNECTORS_SECRET.APP_NAME.SECRET existe, mais a été créé par un autre rôle, alors sa propriété doit être transférée à votre rôle.

   • Si CONNECTORS_SECRET.APP_NAME.NETWORK_RULE existe, mais a été créé par un autre rôle, alors sa propriété doit être transférée à votre rôle.

   Sélectionner 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.