Partager via

LIST

S’applique à :coche marquée oui Databricks SQL coche marquée oui Databricks Runtime 10.4 LTS et versions ultérieures oui coché Unity Catalog uniquement

Répertorie les objets immédiatement contenus au niveau de l’URL.

Syntaxe

LIST url [ WITH ( CREDENTIAL credential_name ) ] [ LIMIT limit ]

Paramètres

  • url

    Littéral STRING avec l’emplacement du stockage cloud décrit comme une URL absolue.

  • credential_name

    Informations d’identification nommées facultatives utilisées pour accéder à cette URL. Si vous fournissez des informations d’identification, elles doivent être suffisantes pour accéder à l’URL. Si vous ne fournissez pas d’informations d’identification, l’URL doit être contenue dans un emplacement externe auquel vous avez accès.

  • limit

    Constante facultative INTEGER utilisée pour limiter le nombre d’objets retournés.

    Dans Databricks Runtime 10.4 LTS, la limite par défaut est 1001 et seules les valeurs comprises entre 1 et 1001 sont prises en charge.

Retours

Un jeu de résultats comportant les colonnes suivantes :

  • path STRING NOT NULL: URI complet de l’objet de stockage.
  • name STRING NOT NULL: nom de l’objet de stockage, y compris son extension.
  • size BIGINT NOT NULL: taille de l’objet en octets. 0 pour les répertoires.
  • modification_time BIGINT NOT NULL: horodatage Unix de la dernière modification de l’objet en millisecondes. Pour convertir cette valeur en type TIMESTAMP , utilisez CAST(modification_time / 1000 AS TIMESTAMP) ou to_timestamp(modification_time / 1000).

Exemples

> LIST 'abfss://container@storageaccount.dfs.core.windows.net/some_dir' WITH (CREDENTIAL azure_some_dir) LIMIT 2
  path                                                                  name   size modification_time
  --------------------------------------------------------------------- ------ ---- -----------------
  abfss://container@storageaccount.dfs.core.windows.net/some_dir/table1 table1 0    1706105124000
  abfss://container@storageaccount.dfs.core.windows.net/some_dir/table2 table2 1024 1706201562000
  • Last updated on