CREATE EXTERNAL LOCATION
適用対象: 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]
ハイフン (-
) などの特殊文字を含むオブジェクト名は、バッククォート (` `
) で囲む必要があります。 アンダースコア (_
) を含むオブジェクト名にはバッククォートは必要ありません。 「名前」と「例」を参照してください。
パラメーター
-
作成する場所の名前。
IF NOT EXISTS
指定した名前の場所が存在しない場合は作成します。 同じ名前の場所が既に存在する場合は、何も起こりません。
url_str
絶対 URL として記述されたクラウド ストレージの場所を持つ
STRING
リテラル。 単一引用符で囲む必要があります。-
この場所への接続に使用される名前付き資格情報。
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';