Fonctionnalité obsolète

Cette rubrique décrit la fonctionnalité de l’API SQL de Snowflake qui a été rendue obsolète dans la version 5.40 de Snowflake.

Voir le API REST SQL Snowflake pour des informations sur le comportement actuel de l’API SQL.

Dans ce chapitre :

Utilisation de la fonctionnalité de l’API SQL obsolète

La version actuelle de l’API SQL est activée par défaut. Pour accéder à la version obsolète, utilisez les points de terminaison suivants :

Point de terminaison

Description

/api/statements/

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

/api/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/statements/statementHandle/cancel

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

Note

Ces points de terminaison ne sont plus pris en charge et sont fournis uniquement à des fins de rétrocompatibilité. Ils seront désactivés dans une prochaine version.

Fonctionnalités modifiées et obsolètes

Lors de l’utilisation de la fonctionnalité de l’API SQL obsolète, si vous définissez le paramètre de requête pageSize pour paginer les résultats, Snowflake renvoie la première page de résultats dans la réponse. Vous pouvez utiliser le champ numPages de l’objet ResultSet_resultSetMetaData dans l’objet ResultSet pour déterminer le nombre total de pages de résultats.

Pour obtenir la page de résultats suivante ou d’autres pages de résultats, utilisez les URLs fournies dans l’en-tête Link dans la réponse HTTP. L’en-tête Link spécifie les URLs pour récupérer la première page de résultats, la suivante, la précédente et la dernière.

La fonctionnalité suivante est modifiée ou obsolète :

  • Vous pouvez spécifier le paramètre nullable dans les requêtes GET et POST.

  • Utilisez le paramètre pageSize pour spécifier le nombre de lignes retournées par une requête. La taille de la page peut varier entre le nombre minimum (10) et le nombre maximum (10 000) de lignes par page. Par défaut, le nombre de lignes retournées varie en fonction de l’exécution de l’instruction.

  • Vous pouvez utiliser le paramètre page pour identifier la page de résultats à retourner. Ce nombre peut aller de 0 au nombre total de pages moins 1.

  • Les numéros de ligne sont renvoyés par défaut comme faisant partie de l’ensemble de données.

Vérification de la taille de la page du jeu de résultats par rapport à la limite autorisée

La fonctionnalité obsolète dans l’API SQL peut renvoyer une page de jeu de résultats qui a une taille maximale d’environ 10 MB.

Si la page du jeu de résultats dépasse cette taille, le point de terminaison renvoie une réponse HTTP 200 avec un jeu de résultats tronqué dans le corps et le champ code défini sur 391908 :

HTTP/1.1 200 OK
...
{
  "code": "391908",
  ...
}
Copy

Si cela se produit, envoyez à nouveau la requête avec le paramètre pageSize fixé à une valeur plus petite qui respecte la taille maximale d’une page.