Installer et configurer Snowflake Connector for Google Analytics Aggregate Data¶

Installer le Snowflake Connector for Google Analytics Aggregate Data¶

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 Snowflake Connector for Google Analytics Aggregate Data, puis sélectionnez la vignette du connecteur.

4. Sur la page Snowflake Connector for Google Analytics Aggregate Data, sélectionnez Get.

   Une boîte de dialogue apparaît.

5. Sous Options, pour Application name, saisissez un nom pour la base de données à utiliser pour l’instance de connecteur.

   Cette base de données est créée automatiquement pour vous.

6. Pour Warehouse used for installation, sélectionnez l’entrepôt à utiliser pour l’installation du 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. Lors d’une procédure ultérieure, vous créerez un entrepôt distinct à cette fin.

Configurer Snowflake Connector for Google Analytics Aggregate Data¶

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 Data Products » Apps.

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

   L’assistant de configuration démarre.

4. Assurez-vous que toutes les conditions préalables requises de la liste sont remplies et marquez-les comme étant remplies.

5. Cliquez sur Start configuration.

6. Renseignez les champs suivants :

   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 (par exemple, si vous réinstallez le connecteur).

   Champ	Description
   Warehouse	Saisissez l’identificateur d’un nouvel entrepôt virtuel dédié au connecteur. Indiquez un nom unique pour votre compte. Le nom de l’entrepôt doit être un identificateur d’objet valide. Le processus de configuration crée un nouvel entrepôt X-Small avec le nom spécifié.
   Destination Database	Saisissez l’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 à partir de Google Analytics seront stockées 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é.
   Destination Schema	Saisissez l’identificateur d’un nouveau schéma qui contiendra les données Google Analytics dans Snowflake. Le Snowflake Connector for Google Analytics Aggregate 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é.
   Role	Saisissez l’identificateur d’un nouveau rôle personnalisé pour le connecteur. Ce rôle a un accès en lecture sur les tables et les vues contenant les données Google Analytics ingérées par le connecteur. Le nom du rôle doit être un identificateur d’objet valide. Le processus de configuration crée un nouveau rôle avec le nom spécifié.

7. Sélectionnez Configure au bas de l’écran.

   Le processus de configuration peut prendre plusieurs minutes. Une fois terminé, l’assistant passe à l’étape Authentification.

8. Pour spécifier l’authentification, suivez l’une des options suivantes :

   Note

   Snowflake Connector for Google Analytics Aggregate Data prend en charge deux méthodes d’authentification dans Google Analytics : comptes de service et OAuth2. Chaque méthode nécessite une configuration supplémentaire dans votre projet Google Cloud. Pour plus d’informations, voir Configurer l’authentification du compte de service de Google Cloud et Configurer l’authentification OAuth pour Google Cloud.

   • Pour un compte de service, renseignez les champs suivants :

   Champ	Description
   Client email	E-mail du compte de service Google qui a été généré lors de la création du compte de service dans votre projet Google Cloud
   Private key	Clé privée qui a été générée lors de la création du compte de service dans votre projet Google Cloud Assurez-vous que les symboles —–BEGIN PRIVATE KEY—–, —–END PRIVATE KEY —– et \n sont supprimés.

   • Pour Oauth2, renseignez les champs suivants :

   Champ	Description
   Client id	ID de client qui a été généré dans votre projet Google Cloud
   Client secret	Secret de client qui a été généré pour l’ID de client

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

   • Vous devez avoir le privilège CREATE 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.

9. Sélectionnez Connect.

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

10. En option : Complétez la boîte de dialogue d’authentification OAuth Google.

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

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.