Compartilhar via

ALTER EXTERNAL LOCATION

  • Artigo

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

Altera as propriedades de um local externo ou renomeia o local.

Sintaxe

ALTER EXTERNAL LOCATION location_name
   { RENAME TO to_location_name |
     SET URL url_str [ FORCE ] |
     SET STORAGE CREDENTIAL credential_name |
     [ SET ] OWNER TO principal }

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

Parâmetros

  • location_name

    Identifica o local externo que está sendo alterado.

  • RENAME TO to_location_name

    Renomeia o local. O nome deve ser exclusivo entre todos os locais no metastore.

  • DEFINIR URL url_str [ FORÇA ]

    url_str deve ser uma literal STRING com o local do armazenamento em nuvem descrito como uma URL absoluta.

    A menos que você especifique FORCE, a instrução falhará se o local estiver em uso no momento.

  • SET STORAGE CREDENTIAL credential_name

    Atualiza a credencial nomeada usada para acessar esse local. Se a credencial não existe, o SQL do Databricks gera um erro.

  • [ SET ] OWNER TO principal

    Transfere a propriedade do local de armazenamento para principal.

    Aplica-se a:verificação marcada como sim SQL do Databricks marca de seleção positiva Databricks Runtime 11.3 LTS e versões posteriores

    SET é permitido como uma palavra-chave opcional.

Exemplos

Os exemplos a seguir usam nomes de localização que não incluem caracteres especiais, como hifens (-). Qualquer nome de objeto que inclua caracteres especiais, deve ser colocado entre crases (` `). Veja Nomes.

-- Rename a location
> ALTER EXTERNAL LOCATION descend_loc RENAME TO decent_loc;

-- Redirect the URL associated with the location
> ALTER EXTERNAL LOCATION best_loc SET URL 'abfss://container@storageaccount.dfs.core.windows.net/best_location' FORCE;

-- Change the credentials used to access the location
> ALTER EXTERNAL LOCATION best_loc SET STORAGE CREDENTIAL street_cred;

-- Change ownership of the external location
> ALTER EXTERNAL LOCATION best_loc OWNER TO `alf@melmak.et`