Utilisation des actions Snowflake dans les workflows d’actions

Suite, toutes les versions

Team, Growth, Professional, Enterprise ou Enterprise Plus

Support

Team, Professional ou Enterprise

Résumé ◀▼

Vous pouvez connecter les workflows d’actions à Snowflake en utilisant l’authentification OAuth 2.0 pour automatiser les workflows qui impliquent des requêtes SQL, des recherches de tableaux et des consultations des schémas. Utilisez un compte de service dédié pour une intégration sécurisée. Les actions disponibles vous permettent d’exécuter des instructions SQL, de trouver des tableaux avec des filtres de schémas et de récupérer des informations détaillées sur les schémas des tableaux, ce qui vous aide à gérer les données et automatiser les tâches efficacement sur les deux plateformes.

En connectant le créateur d’actions à des systèmes externes, comme Snowflake, les administrateurs peuvent intégrer Zendesk à des systèmes externes dans des workflows automatisés, ce qui améliore la collaboration et permet d’assurer une expérience fluide et cohérente sur plusieurs plateformes.

Remarque – Les étapes associées aux systèmes externes dans des workflows d’actions sont appelées collectivement des actions externes.

Cet article aborde les sujets suivants :

Connexion de Snowflake au créateur d’actions
Utilisation des actions Snowflake dans les workflows d’actions

Connexion de Snowflake au créateur d’actions

Avant de pouvoir inclure des actions externes dans vos workflows d’actions, vous devez connecter le créateur d’actions au système externe.

Lorsque vous vous connectez à des systèmes externes pour les utiliser dans des workflows d’actions, nous vous conseillons de suivre ces meilleures pratiques :

Toutes les actions externes effectuées par un workflow d’actions sont attribuées à l’utilisateur qui a connecté le système externe. Il est donc recommandé d’utiliser un compte de service dédié plutôt que des identifiants personnels quand vous vous connectez à chaque système externe.
Toutes les intégrations nécessitent des portées obligatoires. Cependant, il est important d’examiner et de valider les portées avant de valider l’accès au système externe.
Si vous gérez les identifiants pour les outils basés sur des clés API, comme OpenAI, nous vous conseillons de stocker les clés dans un gestionnaire d’identifiants ou un coffre-fort sécurisé.

La connexion Snowflake utilise l’authentification OAuth 2.0 avec le type d’octroi Code d’autorisation. Vous devrez fournir trois informations :

Identifiant du compte : l’identifiant de votre compte Snowflake (par exemple, APAC_DEV.AWS_AP_NORTHEAST_1)
ID client OAuth : l’ID client OAuth de votre intégration de sécurité Snowflake
Secret client OAuth : le secret client OAuth de votre intégration de sécurité Snowflake

Pour configurer l’authentification OAuth dans Snowflake

Créez une intégration de sécurité dans Snowflake avec des paramètres OAuth.
Générez l’ID client et le secret client.
Configurez les URL de redirection appropriées pour les workflows d’actions.

Pour connecter le créateur d’actions à Snowflake

Dans le Centre d’administration, cliquez sur Applications et intégrations () dans la barre latérale, puis sélectionnez Actions > Workflows d’actions.
Créez ou modifiez un workflow d’actions.
Ouvrez la barre latérale.
Sous Actions externes, cliquez sur Snowflake.
Cliquez sur Connexion.
Suivez les prompts de Snowflake pour vous authentifier et terminer la connexion.
Le connecteur utilise la portée refresh_token pendant l’authentification. Le rôle et l’entrepôt sont spécifiés par action au moment de l’exécution, ce qui vous permet de choisir les ressources appropriées en fonction des besoins.

Vérifiez les permissions demandées avec soin avant d’autoriser la connexion. Ne partagez pas votre secret client et ne le placez pas dans le système de contrôle de version.

Remarque – Toutes les actions externes effectuées par un workflow d’actions sont attribuées à l’utilisateur qui a connecté le système externe. Il est donc recommandé d’utiliser un compte de service dédié plutôt que des identifiants personnels quand vous vous connectez à chaque système externe.

Une fois connecté au système, vous verrez un indicateur de connexion et des détails sur l’instance à laquelle vous êtes connecté, ainsi que les actions disponibles pour Snowflake.

Utilisation des actions Snowflake dans les workflows d’actions

Les actions Snowflake suivantes sont disponibles :

Exécution de la requête
Rechercher des tableaux
Rechercher le schéma de tableau

Exécution de la requête

Utilisez l’action Exécution de la requête pour exécuter des instructions SQL arbitraires dans Snowflake.

Cette action a les entrées et les sorties suivantes :

Variables

Entrées

	Variables
Entrées	Obligatoires : `SQL statement`, `Warehouse`, `Role` Facultative : `Timeout` Prenez en compte ce qui suit lorsque vous utilisez l’action Exécution de la requête : Le champ d’instruction SQL prend en charge tous les types d’instructions SQL, notamment SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, etc. Le champ de Warehouse est un menu déroulant dans lequel vous pouvez rechercher les entrepôts disponibles. Le champ de rôle est un menu déroulant dans lequel vous pouvez rechercher les rôles disponibles. Le champ de délai spécifie le délai d’expiration de la requête en secondes. Pour les requêtes SELECT, le tableau de données contient les données de ligne sous la forme de paires clé-valeur.. Pour les opérations INSERT, UPDATE ou DELETE, le champ de lignes affectées affiche le nombre de lignes modifiées.
Sortie	Les résultats de l’exécution des requêtes, notamment le pointeur d’instruction, l’URL de statut, le message d’exécution, le nombre de lignes, les lignes affectées et le tableau de données pour les requêtes SELECT.

Obligatoires : SQL statement, Warehouse, Role

Facultative : Timeout

Prenez en compte ce qui suit lorsque vous utilisez l’action Exécution de la requête :

Le champ d’instruction SQL prend en charge tous les types d’instructions SQL, notamment SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, etc.
Le champ de Warehouse est un menu déroulant dans lequel vous pouvez rechercher les entrepôts disponibles.
Le champ de rôle est un menu déroulant dans lequel vous pouvez rechercher les rôles disponibles.
Le champ de délai spécifie le délai d’expiration de la requête en secondes.
Pour les requêtes SELECT, le tableau de données contient les données de ligne sous la forme de paires clé-valeur..
Pour les opérations INSERT, UPDATE ou DELETE, le champ de lignes affectées affiche le nombre de lignes modifiées.

Sortie Les résultats de l’exécution des requêtes, notamment le pointeur d’instruction, l’URL de statut, le message d’exécution, le nombre de lignes, les lignes affectées et le tableau de données pour les requêtes SELECT.

Rechercher des tableaux

Utilisez l’action Rechercher des tableaux pour découvrir des tableaux dans un schéma de base de données Snowflake avec filtrage facultatif des schémas

Cette action a les entrées et les sorties suivantes :

Variables

Entrées

	Variables
Entrées	Obligatoires : `Database`, `Schema`, `Warehouse`, `Role` Facultative : `Table name pattern` Prenez en compte ce qui suit lorsque vous utilisez l’action Rechercher des tableaux : Le champ de base de données est un menu déroulant dans lequel vous pouvez rechercher les bases de données disponibles. Le champ de schéma est un menu déroulant dans lequel vous pouvez effectuer des recherches, qui dépend de la base de données sélectionnée. Le champ de schéma de nom du tableau accepte les schémas LIKE SQL pour le filtrage (par exemple, « USER% » pour trouver les tableaux qui commencent par USER). Les champs de Warehouse et de rôle sont des menus déroulants dans lesquels vous pouvez effectuer des recherches.
Sortie	Un tableau d’objets de tableau contenant le nom, le type, le nombre de lignes, la taille en octets et la date de création, plus le nombre total. Le champ de type indique le type de tableau (TABLE, VIEW, etc.).

Obligatoires : Database, Schema, Warehouse, Role

Facultative : Table name pattern

Prenez en compte ce qui suit lorsque vous utilisez l’action Rechercher des tableaux :

Le champ de base de données est un menu déroulant dans lequel vous pouvez rechercher les bases de données disponibles.
Le champ de schéma est un menu déroulant dans lequel vous pouvez effectuer des recherches, qui dépend de la base de données sélectionnée.
Le champ de schéma de nom du tableau accepte les schémas LIKE SQL pour le filtrage (par exemple, « USER% » pour trouver les tableaux qui commencent par USER).
Les champs de Warehouse et de rôle sont des menus déroulants dans lesquels vous pouvez effectuer des recherches.

Sortie

Un tableau d’objets de tableau contenant le nom, le type, le nombre de lignes, la taille en octets et la date de création, plus le nombre total.

Le champ de type indique le type de tableau (TABLE, VIEW, etc.).

Rechercher le schéma de tableau

Utilisez l’action Rechercher le schéma de tableau pour récupérer les métadonnées et les définitions personnalisées pour un tableau Snowflake spécifique.

Cette action a les entrées et les sorties suivantes :

Variables

Entrées

	Variables
Entrées	Obligatoires : `Database`, `Schema`, `Table`, `Warehouse`, `Role` Prenez en compte ce qui suit lorsque vous utilisez l’action Rechercher le schéma du tableau : Le champ de base de données est un menu déroulant dans lequel vous pouvez rechercher les bases de données disponibles. Le champ de schéma est un menu déroulant dans lequel vous pouvez effectuer des recherches, qui dépend de la base de données sélectionnée. Le champ de tableau est un menu déroulant dans lequel vous pouvez effectuer des recherches, qui dépend de la base de données et du schéma sélectionnés. Les champs de Warehouse et de rôle sont des menus déroulants dans lesquels vous pouvez effectuer des recherches.
Sortie	Un tableau d’objets de colonnes contenant le nom, le type de données, le statut « nullable », la valeur par défaut et l’indicateur de clés primaires, en plus d’un tableau des noms des colonnes des clés primaires. La sortie des colonnes inclut des informations sur le type de données (par exemple, VARCHAR, NUMBER, DATE), si chaque colonne accepte des valeurs nulles, les valeurs par défaut si elles sont définies et si le tableau fait partie de la clé primaire. Le champ des clés primaires fournit une liste des noms de toutes les colonnes des clés primaires pour plus de commodité.

Obligatoires : Database, Schema, Table, Warehouse, Role

Prenez en compte ce qui suit lorsque vous utilisez l’action Rechercher le schéma du tableau :

Le champ de base de données est un menu déroulant dans lequel vous pouvez rechercher les bases de données disponibles.
Le champ de schéma est un menu déroulant dans lequel vous pouvez effectuer des recherches, qui dépend de la base de données sélectionnée.
Le champ de tableau est un menu déroulant dans lequel vous pouvez effectuer des recherches, qui dépend de la base de données et du schéma sélectionnés.
Les champs de Warehouse et de rôle sont des menus déroulants dans lesquels vous pouvez effectuer des recherches.

Sortie

Un tableau d’objets de colonnes contenant le nom, le type de données, le statut « nullable », la valeur par défaut et l’indicateur de clés primaires, en plus d’un tableau des noms des colonnes des clés primaires.

La sortie des colonnes inclut des informations sur le type de données (par exemple, VARCHAR, NUMBER, DATE), si chaque colonne accepte des valeurs nulles, les valeurs par défaut si elles sont définies et si le tableau fait partie de la clé primaire. Le champ des clés primaires fournit une liste des noms de toutes les colonnes des clés primaires pour plus de commodité.