Configuration de Snowflake Connector for MySQL via Snowsight

Note

Le Snowflake Connector for MySQL est soumis aux Conditions du connecteur.

Note

Pour les comptes dans lesquels le paramètre AUTOCOMMIT est défini sur false, il doit être défini au niveau des sessions lors de la configuration sur true via la commande SQL ALTER SESSION SET AUTOCOMMIT=TRUE.

Le processus de configuration de Snowflake Connector for MySQL via Snowsight comprend les étapes suivantes :

Dans ce chapitre :

Configuration de la journalisation pour le connecteur

Snowflake Connector for MySQL utilise la table d’événements pour stocker les événements et les journaux générés par le code du connecteur. La configuration d’une table d’événements est une étape obligatoire.

Note

Si la table d’événements est déjà configurée pour le compte utilisé pour le connecteur, ignorez cette étape.

Pour créer une table d’événements, procédez comme suit :

CREATE EVENT TABLE IF NOT EXISTS <fully_qualified_event_table_name> CHANGE_TRACKING = TRUE;
ALTER ACCOUNT SET EVENT_TABLE = <fully_qualified_event_table_name>;
Copy

Où :

fully_qualified_event_table_name

Spécifie le nom de la table d’événements.

Vous trouverez plus d’informations sur une table d’événements ici.

Installation de l”Snowflake Connector for MySQL

La procédure suivante décrit comment installer le connecteur :

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

  2. Dans la navigation de gauche, sélectionnez Data Products » Marketplace.

  3. Recherchez le Snowflake Connector for MySQL, puis sélectionnez la vignette du connecteur.

  4. Dans la page Snowflake Connector for MySQL, 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 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 depuis la base de données MySQL. Dans une étape ultérieure, vous créerez un entrepôt distinct à cette fin.

    2. Sous Options » Application name, vous pouvez choisir de modifier le nom de l’application.

    3. Sélectionnez Get.

  5. Une boîte de dialogue apparaît avec la notification : Successfully Installed. Pour poursuivre la configuration, sélectionnez Configure.

    La boîte de dialogue se ferme et la page Snowflake Connector for MySQL affiche l’UI de configuration et de gestion du connecteur.

Facultatif : Installation de plusieurs instances de Snowflake Connector for MySQL

Vous pouvez installer plusieurs instances de la même application de connecteur sur votre compte Snowflake.

Pour installer une instance d’application supplémentaire, procédez comme suit :

  1. Connectez-vous à Snowsight.

  2. Accédez à Snowflake Marketplace et sélectionnez l’application pour laquelle vous souhaitez installer une autre instance. La page de détails de l’application apparaît.

  3. Cliquez sur Add instance. La boîte de dialogue d’installation apparaît.

  4. Fournissez le nom de l’instance et sélectionnez l’entrepôt à utiliser lors de l’installation.

  5. Sélectionnez Get pour démarrer le processus d’installation.

L’ajout d’instances de connecteur peut prendre plusieurs minutes. Une fois le processus d’installation terminé, vous recevez une notification par e-mail.

Attention

Pour éviter la corruption des données ingérées, lors de la configuration du connecteur, utilisez toujours un schéma de base de données différent de celui de toutes les autres applications natives.

Pour accéder aux instances d’application de connecteur que vous avez installées, procédez comme suit :

  1. Connectez-vous à Snowsight.

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

  3. Sélectionnez votre instance d’application pour y accéder.

Configuration du Snowflake Connector for MySQL

  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. Recherchez le Snowflake Connector for MySQL, puis sélectionnez-le. Vous accédez maintenant à la page de l’assistant d’installation, qui vous guidera tout au long du processus de configuration.

Configurez l’application comme suit :

Étape 1 : Remplir les conditions préalables requises

Suivez les étapes préalables requises suivantes pour configurer votre base de données et votre agent :

Étape

Description

Provide access to the source database

Conditions préalables requises pour les sources de données Snowflake Connector for MySQL

Download and install the Agent

Configuration du conteneur Agent Snowflake Connector for MySQL

Sélectionnez Mark as done à la fin de chaque étape.

Sélectionnez Start configuration.

Étape 2 : Configurer

Dans la boîte de dialogue de configuration, saisissez des valeurs pour les champs suivants :

Champ

Description

Compute Warehouse

Identificateur d’un nouvel entrepôt virtuel dédié au connecteur. Cet entrepôt sera utilisé pour traiter les données obtenues auprès de l’agent et les placer dans la table cible.

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

Operational Warehouse

Identificateur d’un nouvel entrepôt virtuel dédié au connecteur. Cet entrepôt servira à gérer les activités du connecteur et de ses agents.

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

Role

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

Indiquez un nom unique pour votre compte. 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é.

User

Identificateur d’un nouvel utilisateur que l’agent utilisera pour s’authentifier auprès de Snowflake.

Spécifiez un nom unique dans la base de données sélectionnée. Le nom de l’utilisateur doit être un identificateur d’objet valide.

Le processus de configuration crée un nouvel utilisateur portant le nom spécifié et de type SERVICE.

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).

Sélectionnez Configure.

Étape 3 : Vérifier la connexion de l’Agent

Vérifiez la connexion de l’agent à Snowflake comme suit :

Sélectionnez Generate file pour générer le fichier de configuration initial de l’agent.

Note

Vous pouvez générer de nouveau le fichier, mais il générera une nouvelle clé privée temporaire pour l’utilisateur utilisé par l’agent. Cela invalidera la clé du fichier précédemment généré.

Utilisez le fichier généré pour configurer l’agent précédemment téléchargé.

Sélectionnez Refresh pour vérifier la connectivité à l’agent.

Si la connexion est établie, une boîte de dialogue apparaît. Sélectionnez Define data to sync pour accéder à la page d’accueil du connecteur.

Prochaines étapes

Après avoir effectué ces procédures, suivez les étapes à la section Configuration du conteneur Agent Snowflake Connector for MySQL.

Langage: Français