Ler em inglês

Partilhar via

ALTER EXTERNAL LOCATION

  • Artigo

Aplica-se a:assinalado com sim Databricks SQL assinalado com sim Databricks Runtime 10.4 LTS e superior assinalado com sim Unity Catalog apenas

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 hífenes (-), deve ser cercado por backticks (` `). Os nomes de objetos com sublinhados (_) não exigem backticks. Consulte Nomes e exemplos.

Parâmetros

  • location_name

    Identifica o local externo que está sendo alterado.

  • RENOMEIE PARA to_location_name

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

  • SET URL url_str [ FORÇAR ]

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

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

  • SET CREDENCIAL DE ARMAZENAMENTO credential_name

    Atualiza a credencial nomeada usada para acessar esse local. Se a credencial não existir, o Databricks SQL gerará um erro.

  • [ SET ] PROPRIETÁRIO A principal

    Transfere a propriedade do local de armazenamento para o principal.

    Aplica-se a:Marque Sim Databricks SQL Marque Sim Databricks Runtime 11.3 LTS e superior

    SET é permitido como palavra-chave opcional.

Exemplos

Os exemplos a seguir usam nomes de locais que não incluem caracteres especiais, como hífenes (-). Qualquer nome de objeto que inclua caracteres especiais deve ser cercado por backticks (` `). Consulte 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`