Sdílet prostřednictvím

VYTVOŘIT EXTERNÍ UMÍSTĚNÍ

  • Článek

Platí pro: zaškrtnutí označeného ano Databricks SQL zaškrtnutí označeného ano Databricks Runtime 10.4 LTS a vyšší zaškrtnutí označeného ano pouze katalog Unity

Vytvoří externí umístění se zadaným názvem. Pokud umístění se stejným názvem již existuje, vyvolá se výjimka.

Pokyny k postupu najdete v tématu Vytvoření externího umístění pro připojení cloudového úložiště k Azure Databricks.

Syntaxe

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

Libovolný název objektu, který obsahuje speciální znaky, jako jsou spojovníky (-), musí být obklopený zpětnými znaky (` `). Názvy objektů s podtržítky (_) nevyžadují zpětné znaky. Viz názvy a příklady.

Parametry

  • location_name

    Název umístění, které se má vytvořit.

  • POKUD NEEXISTUJE

    Vytvoří umístění s daným názvem, pokud neexistuje. Pokud umístění se stejným názvem již existuje, nic se nestane.

  • url_str

    Literál STRING s umístěním cloudového úložiště, které je popsáno jako absolutní adresa URL. Musí být obklopen jednoduchými uvozovkami.

  • credential_name

    Pojmenované přihlašovací údaje použité pro připojení k tomuto umístění.

  • komentář

    Volitelný popis umístění nebo NULL. Výchozí hodnota je NULL.

Příklady

-- 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';

Všimněte si backticks (` `) kolem externího umístění a názvů přihlašovacích údajů úložiště v následujícím příkladu. Backticks jsou vyžadovány pro názvy objektů, které obsahují speciální znaky, jako jsou spojovníky (-). Názvy objektů s podtržítky (_například názvy objektů v předchozím příkladu) nevyžadují zpětné znaky. Viz názvy.

-- 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';