CREATE EXTERNAL LOCATION

  • [アーティクル]

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

指定した名前で外部の場所を作成します。 同じ名前の場所が既に存在する場合は、例外がスローされます。

方法については、「クラウド ストレージを Azure Databricks に接続するための外部の場所を作成する」を参照してください。

構文

CREATE EXTERNAL LOCATION [IF NOT EXISTS] location_name
    URL url_str
    WITH (STORAGE CREDENTIAL credential_name)
    [COMMENT comment]

ハイフン (-) などの特殊文字を含むオブジェクト名は、バッククォート (` `) で囲む必要があります。 アンダースコア (_) を含むオブジェクト名にはバッククォートは必要ありません。 「名前」と「例」を参照してください。

パラメーター

  • location_name

    作成する場所の名前。

  • IF NOT EXISTS

    指定した名前の場所が存在しない場合は作成します。 同じ名前の場所が既に存在する場合は、何も起こりません。

  • url_str

    絶対 URL として記述されたクラウド ストレージの場所を持つ STRING リテラル。 単一引用符で囲む必要があります。

  • credential_name

    この場所への接続に使用される名前付き資格情報。

  • comment

    場所の説明 (省略可能)、または NULL。 既定値は、NULL です。

例

-- Create a location accessed using the abfss_remote_cred credential
> CREATE EXTERNAL LOCATION abfss_remote URL 'abfss://container@storageaccount.dfs.core.windows.net/location'
    WITH (STORAGE CREDENTIAL abfss_remote_cred)
    COMMENT 'Default source for Azure exernal data';

次の例では、外部の場所とストレージの資格情報の名前を囲むバッククォート (` `) があることに注意してください。 バッククォートは、ハイフン (-) などの特殊文字を含むオブジェクト名に必要です。 前の例のように、アンダースコア (_) を含むオブジェクト名にはバッククォートは必要ありません。 「名前」を参照してください。

-- Create a location accessed using the abfss_remote_cred credential
> CREATE EXTERNAL LOCATION `abfss-remote` URL 'abfss://container@storageaccount.dfs.core.windows.net/location'
    WITH (STORAGE CREDENTIAL `abfss-remote-cred`)
    COMMENT 'Default source for Azure exernal data';