LIST

S’applique à :coché oui Databricks SQL coché oui Databricks Runtime 10.4 LTS et supérieurs coché oui uniquement Catalogue Unity

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’identifiants, 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: L’URI complet de l’objet de stockage.
  • name STRING NOT NULL: Le nom de l’objet de stockage, y compris son extension.
  • size BIGINT NOT NULL: La taille de l’objet en octets. 0 pour les annuaires.
  • modification_time BIGINT NOT NULL: L’horodatage Unix du dernier temps de 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