Conditions préalables

L’étape des conditions préalables est la première étape de la phase d’assistant du connecteur. Cette étape est totalement facultative, mais elle est recommandée si l’utilisateur final a besoin d’effectuer des performances supplémentaires en dehors de l’application native ou même du contexte Snowflake. Il peut s’agir, par exemple, de mettre en place un système d’authentification et d’autorisation dans le système source à partir duquel les données seront importées.

Pour configurer les conditions préalables, elles doivent être insérées dans la table STATE.PREREQUISITES lors de l’installation du connecteur. La plupart des colonnes de cette table devraient s’expliquer d’elles-mêmes. Les colonnes d’URL doivent être utilisées pour fournir à l’utilisateur final plus d’informations sur les configurations requises. Dans le cas où il est nécessaire de fournir quelque chose de plus personnalisé dans les conditions préalables, la colonne custom_properties doit être utilisée.

La phase des conditions préalables se compose de deux étapes :

  1. Marquer les conditions préalables comme étant remplies

  2. Compléter l’étape

Exigences

Les conditions préalables exigent qu’au moins les fichiers SQL suivants soient exécutés lors de l’installation de l’application native :

  • core.sql

  • configuration/prerequisites.sql

Marquer les conditions préalables comme étant remplies

Cette étape peut être réalisée de deux manières différentes. Les conditions préalables peuvent être marquées une à une comme étant remplies ou toutes ensemble. Le résultat final est le même, la valeur de is_completed est fixée sur true pour chacune des conditions préalables. Cette étape est gérée par les procédures suivantes :

  • PUBLIC.MARK_ALL_PREREQUISITES_AS_DONE()

  • PUBLIC.UPDATE_PREREQUISITE(ID VARCHAR, IS_COMPLETED BOOLEAN)

Ces deux procédures exigent que le connecteur soit dans le statut CONFIGURING et que le statut de configuration ne soit pas FINALIZED.

Compléter l’étape

Pour terminer l’étape des conditions préalables, appelez la procédure PUBLIC.COMPLETE_PREREQUISITES_STEP(). Cette procédure n’a aucun effet si le connecteur n’est pas dans le statut CONFIGURING avec le statut de configuration INSTALLED.

Si c’est le cas, le statut sera mis à jour avec la valeur suivante :

{
    "status": "CONFIGURING",
    "configurationStatus": "PREREQUISITES_DONE"
}
Copy

Cette procédure nécessite que le connecteur soit dans le statut CONFIGURING et que le statut de configuration ne soit pas FINALIZED.

Langage: Français