À propos de Openflow Connector for SQL Server¶

Workflow¶

Le workflow suivant décrit les étapes pour configurer et exécuter Openflow Connector for SQL Server :

1. L’administrateur de la base de données du serveur SQL effectue les tâches suivantes :

   1. Configure les paramètres de réplication de SQL Server et active le suivi des modifications sur les bases de données et les tables en cours de réplication.

   2. Crée des identifiants de connexion pour le connecteur.

   3. (Facultatif) Fournit le certificat SSL pour se connecter à l’instance SQL Server sur SSL.

2. Un administrateur de compte Snowflake effectue les tâches suivantes :

   1. Crée un utilisateur de service pour le connecteur, une base de données de destination pour stocker les données répliquées, et un entrepôt pour le connecteur.

   2. Installe le connecteur.

   3. Spécifie les paramètres requis pour la définition du flux du connecteur.

   4. Gère le flux.

Le connecteur effectue les opérations suivantes lorsqu’il est exécuté dans Openflow :

1. Crée les schémas et les tables de destination correspondant aux tables sources configurées pour la réplication.

2. Commence la réplication conformément au cycle de vie de la réplication de la table.

   Pour plus d’informations, voir Comment les tables sont-elles répliquées ?.

Réplication des données de tables dans plusieurs bases de données SQL Server¶

Le connecteur prend en charge la réplication de tables à partir de plusieurs bases de données SQL Server dans une seule instance SQL Server. Le connecteur crée des tables répliquées à partir de différentes bases de données dans des schémas distincts dans la base de données de destination Snowflake.

Référencez les tables répliquées en combinant le nom de la base de données source, le nom du schéma source, et le nom de la table au format suivant :

<database_name>.<schema_name>.<table_name>

Pour chaque schéma de chaque base de données source en cours de réplication, le connecteur crée un schéma distinct dans la base de données Snowflake de destination. Le nom du schéma de destination est une combinaison du nom de la base de données source et du nom du schéma source, séparés par un caractère tiret bas (_), comme montré dans l’exemple suivant :

<source_database_name>_<source_schema_name>

Le connecteur crée des tables dans le schéma de destination avec le même nom que le nom de la table source, comme montré dans l’exemple suivant :

<destination_database>_<destination_schema_name>.<source_table_name>

Comment les tables sont-elles répliquées ?¶

Le connecteur réplique les tables dans les zones de préparation suivantes :

1. Introspection du schéma : le connecteur découvre les colonnes de la table source, y compris les noms et les types de colonnes, puis les valide par rapport aux limites de Snowflake et du connecteur. Les échecs de validation entraînent l’échec de cette préparation et le cycle s’achève. À l’issue de cette préparation, le connecteur crée une table de destination vide.

2. Chargement d’un instantané : le connecteur copie toutes les données disponibles dans la table source dans la table de destination. Si cette zone de préparation échoue, plus aucune donnée n’est répliquée. Une fois l’opération réussie, les données de la table source sont disponibles dans la table de destination.

3. Chargement incrémentiel : le connecteur suit les modifications apportées à la table source et applique ces modifications à la table de destination. Ce processus se poursuit jusqu’à ce que la table soit retirée de la réplication. Un échec à ce stade arrête définitivement la réplication de la table source, jusqu’à ce que le problème soit résolu.

   Pour plus d’informations sur le contournement du chargement des instantanés et l’utilisation du processus de chargement incrémentiel, consultez Réplication incrémentielle.

Versions du serveur SQL prises en charge¶

La table suivante annonce les versions testées et officiellement prises en charge du serveur SQL:

Exigences Openflow¶

• La taille de l’environnement d’exécution doit être au moins moyenne. Utilisez un environnement d’exécution plus grand lorsque vous répliquez de grands volumes de données, en particulier lorsque la taille des lignes est importante.

• Le connecteur ne prend pas en charge les environnements d’exécution Openflow à plusieurs nœuds. Configurez l’environnement d’exécution de ce connecteur avec Min nodes et Max nodes définis sur 1.

Limitations¶

• Vous ne pouvez pas exécuter plusieurs connecteurs du même type dans une seule instance d’exécution.

• Le connecteur ne prend en charge que l’authentification par nom d’utilisateur et mot de passe avec le serveur SQL.

• Le connecteur ne réplique que les tables dont les types de données sont supportés par Snowflake. Pour obtenir la liste de ces types de données, voir Résumé des types de données.

• Le connecteur ne réplique que les tables de la base de données qui contiennent des clés primaires.

• Le connecteur ne met pas à jour les enregistrements existants dans la base de données Snowflake lorsqu’une nouvelle colonne NOT NULL avec une valeur par défaut est ajoutée à l’une des bases de données source.

• Le connecteur ne met pas à jour les enregistrements existants dans la base de données Snowflake lorsqu’une nouvelle colonne est ajoutée à la liste incluse dans le filtre de colonne JSON.

• Après avoir supprimé une colonne dans l’une des bases de données sources et l’avoir rajoutée avec le même nom, les suppressions supplémentaires provoquent des erreurs.

• Après avoir inclus une colonne dans le filtre de colonne JSON et l’avoir exclue, les tentatives d’inclusion supplémentaires provoquent des erreurs.

• Le connecteur prend en charge les modifications du schéma de la table source, à l’exception des modifications des définitions des clés primaires, de la précision ou de l’échelle d’une colonne numérique.

• Le connecteur ne prend pas en charge l’opération de troncature de table.

• Le connecteur ne prend pas en charge le nouvel ajout d’une colonne après sa suppression.

Prochaines étapes¶

Paramétrez Openflow Connector for SQL Server