Compartilhar via

CREATE EXTERNAL LOCATION

Aplica-se a:verificação marcada como sim SQL do Databricks verificação marcada como sim Databricks Runtime 10.4 LTS e versões posteriores caixa de seleção marcada sim Somente Catálogo do Unity

Cria um local externo com o nome especificado. Se um local com o mesmo nome já existir, uma exceção será gerada.

Para obter instruções de instruções, consulte a Opção 2: Criar um local externo usando o SQL.

Sintaxe

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

Qualquer nome de objeto que inclua caracteres especiais, como hifens (-), deve ser colocado entre crases (` `). Nomes de objetos com caracteres sublinhados (_) não exigem backticks. Veja Nomes e Exemplos.

Parâmetros

  • location_name

    O nome do local a ser criado.

  • SE NÃO EXISTIR

    Cria um local com o nome fornecido se ele não existir. Se um local com o mesmo nome já existir, nada acontecerá.

  • url_str

    Um literal STRING com o local do armazenamento em nuvem descrito como uma URL absoluta. Deve estar cercado por aspas simples.

  • credential_name

    A credencial nomeada usada para se conectar a esse local.

  • comentário

    Uma descrição opcional para o local, ou NULL. O padrão é NULL.

Exemplos

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

Observe os acentos graves (` `) em volta dos nomes do local externo e das credenciais de armazenamento no exemplo a seguir. Os acentos graves são necessários para nomes de objeto que incluem caracteres especiais, como hifens (-). Nomes de objeto com sublinhados (_como os do exemplo anterior) não exigem backticks. Veja Nomes.

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