CREATE EXTERNAL LOCATION

Dotyczy:zaznaczono jako tak Databricks SQL zaznaczono jako tak Databricks Runtime 10.4 LTS i nowsze zaznaczono jako tak tylko katalog 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 Opcja 2: Tworzenie lokalizacji zewnętrznej przy użyciu języka SQL.

Permissions

Aby utworzyć lokalizację zewnętrzną, musisz być administratorem magazynu metadanych lub mieć CREATE EXTERNAL LOCATION uprawnienia do magazynu metadanych. Musisz również mieć CREATE EXTERNAL LOCATION uprawnienia do poświadczeń magazynu używanych przez lokalizację.

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 z podkreśleniami (_) nie wymagają backtickó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';
  • Last updated on