À propos des points de terminaison de l’API SQL

L’API SQL est disponible à https://account_identifier.snowflakecomputing.com/api, où account_identifier est votre identificateur de compte.

Depuis la version 6.3 de Snowflake, l’API se compose de la ressource /api/v2/statements/ et fournit les points de terminaison suivants :

Point de terminaison

Description

/api/v2/statements/

Utilisez ce point de terminaison pour soumettre des instructions SQL pour exécution.

/api/v2/statements/statementHandle

Utilisez ce point de terminaison pour vérifier le statut de l’exécution d’une instruction. (statementHandle est un identificateur unique de l’instruction soumise pour exécution).

/api/v2/statements/statementHandle/cancel

Utilisez ce point de terminaison pour annuler l’exécution d’une instruction.

Ces points de terminaison comprennent la nouvelle méthode de récupération des résultats, introduite dans la version 5.40 de Snowflake. Toutefois, lorsque vous envoyez une demande à ces nouveaux points de terminaison, vous n’avez pas besoin de définir le champ format sur jsonv2 dans le champ resultSetMetaData. Si le champ format est défini dans la requête, l’API SQL ignore le champ.

La nouvelle version de l’API SQL supprime également les limites d’accès concurrentiel, ce qui vous permet de récupérer les résultats des requêtes à partir de plusieurs threads.

Vous pouvez utiliser des outils de développement et des bibliothèques pour les APIs REST (par exemple, Postman) pour envoyer des requêtes et traiter les réponses.