DESCRIBE RESULT

Décrit les colonnes dans le résultat d’une requête.

Snowflake conserve le résultat d’une requête pendant un certain temps, après quoi le résultat est purgé. La requête peut provenir de la session en cours ou de l’une de vos autres sessions, y compris les sessions précédentes, tant que la période limitée ne s’est pas écoulée. Cette période n’est pas réglable. Pour plus de détails, voir Utilisation de résultats de requête persistants.

DESCRIBE peut être abrégé en DESC.

Voir aussi :

LAST_QUERY_ID (fonction de contexte), RESULT_SCAN (fonction de table)

Syntaxe

DESC[RIBE] RESULT { '<query_id>' | LAST_QUERY_ID() }
Copy

Paramètres

query_id ou LAST_QUERY_ID()

Spécifie soit l’ID d’une requête que vous avez exécutée (au cours des 24 dernières heures d’une session), soit la fonction LAST_QUERY_ID, qui renvoie l’ID d’une requête dans votre session en cours.

Notes sur l’utilisation

  • Pour récupérer l’ID d’une requête spécifique :

    • Localisez l’ID de requête dans l’interface Web. La page History History tab répertorie l’ID de chaque requête ; cependant, notez que vous ne pouvez utiliser cette fonction que pour les requêtes que vous avez exécutées.

    • Exécutez la fonction de table QUERY_HISTORY , QUERY_HISTORY_BY_*, qui retourne une liste des requêtes et leurs IDs ; cependant, notez que vous ne pouvez utiliser cette fonction que pour les requêtes que vous avez exécutées.

    • Si la requête a été exécutée dans la session en cours, exécutez la fonction LAST_QUERY_ID. Par exemple :

      SELECT LAST_QUERY_ID(-2);
      
      Copy

      Notez que cela équivaut à utiliser LAST_QUERY_ID() comme entrée pour DESC RESULT.

  • Pour post-traiter la sortie de cette commande, vous pouvez utiliser la fonction RESULT_SCAN, qui traite la sortie comme une table qui peut être interrogée.

Exemples

Décrire les colonnes du résultat de la requête spécifiée de l’une de vos sessions (dans un délai de 24 heures maximum) :

DESC RESULT 'f2f07bdb-6a08-4689-9ad8-a1ba968a44b6';
Copy

Décrire les colonnes des résultats de votre requête la plus récente au cours de la session actuelle :

SELECT * FROM boston_sales;

+---------------+-------+-------+--------+-------------+---------------------+-------+
| CITY          | ZIP   | STATE | SQ__FT | TYPE        | SALE_DATE           | PRICE |
|---------------+-------+-------+--------+-------------+---------------------+-------|
| MA-Lexington  | 40502 | MA    |    836 | Residential | 0016-01-25T00:00:00 | 59222 |
| MA-Belmont    | 02478 | MA    |    852 | Residential | 0016-02-21T00:00:00 | 69307 |
| MA-Winchester | 01890 | MA    |   1122 | Condo       | 0016-01-31T00:00:00 | 89921 |
+---------------+-------+-------+--------+-------------+---------------------+-------+

DESC RESULT LAST_QUERY_ID();

+-----------+-------------------+--------+-------+---------+-------------+------------+-------+------------+---------+
| name      | type              | kind   | null? | default | primary key | unique key | check | expression | comment |
|-----------+-------------------+--------+-------+---------+-------------+------------+-------+------------+---------|
| CITY      | VARCHAR(16777216) | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    |
| ZIP       | VARCHAR(16777216) | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    |
| STATE     | VARCHAR(16777216) | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    |
| SQ__FT    | NUMBER(38,0)      | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    |
| TYPE      | VARCHAR(16777216) | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    |
| SALE_DATE | DATE              | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    |
| PRICE     | NUMBER(38,0)      | COLUMN | Y     | NULL    | N           | N          | NULL  | NULL       | NULL    |
+-----------+-------------------+--------+-------+---------+-------------+------------+-------+------------+---------+
Copy