次の方法で共有

LIST

適用対象:check marked yes Databricks SQL Databricks Runtime 10.4 LTS 以降 「はい」のチェック マーク Unity Catalog のみ

URL に直ちに含まれるオブジェクトを一覧表示します。

構文

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

パラメーター

  • url

    絶対 URL として記述されたクラウド ストレージの場所を持つ STRING リテラル。

  • credential_name

    この URL へのアクセスに使用される省略可能な名前付き資格情報。 資格情報を指定する場合は、URL にアクセスするのに十分なものである必要があります。 資格情報を指定しない場合は、自分がアクセス権を持っている外部の場所に URL が含まれている必要があります。

  • リミット

    返されるオブジェクト数を制限するために使用される、省略可能な INTEGER 定数。

    Databricks Runtime 10.4 LTS では、既定の制限は 1001 であり、1 から 1001 の値のみがサポートされます。

返品

次の列を含む結果セット:

  • path STRING NOT NULL: ストレージ オブジェクトの完全な URI。
  • name STRING NOT NULL: ストレージ オブジェクトの名前 (拡張機能を含む)。
  • size BIGINT NOT NULL: オブジェクトのサイズ (バイト単位)。 0 ディレクトリの場合。
  • modification_time BIGINT NOT NULL: オブジェクトの最終変更時刻の Unix タイムスタンプ (ミリ秒単位)。 この値を TIMESTAMP 型に変換するには、 CAST(modification_time / 1000 AS TIMESTAMP) または to_timestamp(modification_time / 1000)を使用します。

例

> 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