ALTER CONNECTION

platí pro:zaškrtnuto Ano Databricks SQL zaškrtnuto Ano Databricks Runtime 13.3 LTS a vyšší zaškrtnuto Ano pouze pro katalog Unity.

Přenese vlastnictví připojení k novému hlavnímu uživateli, přejmenuje připojení nebo změní možnosti připojení.

Chcete-li nastavit komentář k připojení, použijte COMMENT ON PŘIPOJENÍ.

Důležité

Když změníte možnosti připojení, zadejte přihlašovací údaje, jako jsou hesla a tokeny pomocí secret funkce, a ne zadejte hodnoty literálu přímo v klauzuli OPTIONS . To vám umožní odkazovat na tajný klíč uložený v tajné službě Databricks místo zahrnutí hodnoty přihlašovacích údajů do příkazu.

Syntaxe

ALTER CONNECTION connection_name
 { [ SET ] OWNER TO principal |
   RENAME TO new_connection_name |
   OPTIONS ( option value [, ...] )

Parametry

  • connection_name

    Název připojení, které se má změnit.

  • [ SET ] VLASTNÍK NA hlavního subjektu

    Přenese vlastnictví připojení na principal.

  • PŘEJMENOVAT NA new_connection_name

    Určuje nový název připojení. Název musí být v rámci katalogu Unity metastore jedinečný.

  • OPTIONS

    Nastaví connection_type konkrétní parametry potřebné k navázání připojení.

    Nahradí existující seznam možností novým seznamem možností.

    • možnost

      Klíč vlastnosti. Klíč se může skládat z jednoho nebo více identifikátorů oddělených tečkou nebo literálem STRING .

      Klíče vlastností musí být jedinečné a mají rozlišení velkých a malých písmen.

    • value

      Hodnota vlastnosti. Hodnota musí být výraz BOOLEAN, STRING, INTEGERnebo DECIMALkonstanta.

      Pro každou možnost, která nese přihlašovací údaje, jako je heslo nebo token, použijte secret funkci místo přímého zadávání hodnoty. Zadejte například value místo zadávání literálového hesla.passwordsecret('secrets.r.us', 'postgresPassword')

Příklady

> ALTER CONNECTION mysql_connection SET OWNER TO `alf@melmak.et`;

> ALTER CONNECTION mysql_connection RENAME TO `other_mysql_connection`;

> ALTER CONNECTION mysql_connection OPTIONS (host 'newmysqlhost.us-west-2.amazonaws.com', port '3306');