ALTER CONNECTION

Van toepassing op:als gemarkeerd ja Databricks SQL als gemarkeerd ja Databricks Runtime 13.3 LTS en hoger als gemarkeerd ja alleen Unity Catalog

Hiermee draagt u het eigendom van een verbinding over naar een nieuwe principal, wijzigt u de naam van een verbinding of wijzigt u de verbindingsopties.

Als u een opmerking over een verbinding wilt instellen, gebruikt u COMMENT ON CONNECTION.

Important

Wanneer u verbindingsopties wijzigt, geeft u referenties op, zoals wachtwoorden en tokens, met behulp van de secret functie in plaats van de letterlijke waarden rechtstreeks in de component in te OPTIONS voeren. Hiermee kunt u verwijzen naar een geheim dat is opgeslagen in de Databricks-geheime service in plaats van de referentiewaarde in uw instructie op te slaan.

Syntaxis

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

Parameters

  • connection_name

    De naam van de verbinding die moet worden gewijzigd.

  • [ SET ] EIGENAAR NAAR hoofdsom

    Draagt het eigendom van de verbinding over aan principal.

  • NAAM WIJZIGEN IN new_connection_name

    Hiermee geeft u een nieuwe naam voor de verbinding. De naam moet uniek zijn binnen de Unity Catalog-metastore.

  • OPTIES

    Hiermee stelt u connection_type specifieke parameters in die nodig zijn om de verbinding tot stand te brengen.

    Vervangt de bestaande lijst met opties door een nieuwe lijst met opties.

    • optie

      De eigenschapssleutel. De sleutel kan bestaan uit een of meer identificaties, gescheiden door een punt, of een STRING letterlijk.

      Eigenschapssleutels moeten uniek en hoofdlettergevoelig zijn.

    • value

      De waarde voor de eigenschap. De waarde moet een BOOLEAN, STRINGof INTEGERDECIMALconstante expressie zijn.

      Voor elke optie die een referentie, zoals een wachtwoord of token, bevat, gebruikt u de secret functie in plaats van de waarde rechtstreeks in te voeren. Geef bijvoorbeeld de value for op password in secret('secrets.r.us', 'postgresPassword') plaats van het letterlijke wachtwoord in te voeren.

Voorbeelden

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