Udostępnij za pośrednictwem

TWORZENIE LOKALIZACJI ZEWNĘTRZNEJ

  • Artykuł

Dotyczy:zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime 10.4 LTS i nowszy zaznacz pole wyboru oznaczone jako tak tylko wykaz aparatu Unity

Tworzy lokalizację zewnętrzną o określonej nazwie. Jeśli lokalizacja o tej samej nazwie już istnieje, zgłaszany jest wyjątek.

Aby uzyskać instrukcje, zobacz Tworzenie lokalizacji zewnętrznej w celu połączenia magazynu w chmurze z usługą Azure Databricks.

Składnia

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

Każda nazwa obiektu, która zawiera znaki specjalne, takie jak łączniki (-), musi być otoczona przez backticks (` `). Nazwy obiektów ze podkreśleniami (_) nie wymagają backticksów. Zobacz Nazwy i przykłady.

Parametry

  • location_name

    Nazwa lokalizacji do utworzenia.

  • JEŚLI NIE ISTNIEJE

    Tworzy lokalizację o podanej nazwie, jeśli nie istnieje. Jeśli lokalizacja o tej samej nazwie już istnieje, nic się nie stanie.

  • url_str

    Literał STRING z lokalizacją magazynu w chmurze opisany jako bezwzględny adres URL. Musi być otoczony pojedynczymi cudzysłowami.

  • credential_name

    Nazwane poświadczenia używane do nawiązywania połączenia z tą lokalizacją.

  • komentarz

    Opcjonalny opis lokalizacji lub NULL. Wartość domyślna to NULL.

Przykłady

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

Zwróć uwagę na backticks (` `) wokół lokalizacji zewnętrznej i nazw poświadczeń magazynu w poniższym przykładzie. Backticks są wymagane w przypadku nazw obiektów zawierających znaki specjalne, takie jak łączniki (-). Nazwy obiektów ze podkreśleniami (_), takie jak te w poprzednim przykładzie, nie wymagają backticksów. Zobacz Nazwy.

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