- Kategorien:
Systemfunktionen (Systemsteuerung)
SYSTEM$REGISTER_CMK_INFO¶
Registers your customer-managed key (CMK) for use with Tri-Secret Secure.
Syntax¶
AWS:
SYSTEM$REGISTER_CMK_INFO( '<cmk_arn>' [ , '<privatelink_enabled>' ] )
Azure:
SYSTEM$REGISTER_CMK_INFO( '<vault_uri>' , '<key_name>' [ , '<privatelink_enabled>' ] )
Google Cloud
SYSTEM$REGISTER_CMK_INFO( '<project_id>' , '<location>', '<key_ring>' , '<key_name>' )Bemerkung
Private Konnektivität wird derzeit von Google Cloud nicht unterstützt.
Argumente¶
Erforderlich
AWS
cmk_arnGibt die Amazon Web Services-Ressourcennummer (ARN) an, die den kundenverwalteten Schlüssel (CMK) zur Verwendung mit Tri-Secret Secure angibt.
Azure
vault_uriGibt den eindeutigen Microsoft Azure-Endpunktbezeichner Ihres Azure Key Vault an.
key_nameGibt den Namen Ihres CMK auf Microsoft Azure an.
Google Cloud
project_idGibt den eindeutigen Bezeichner für Ihr Projekt auf Google Cloud Platform an.
locationGibt die Google Cloud Platform-Region an, die Ihr Snowflake-Konto hostet.
key_ringSpecifies the key ring for your CMK in Google Cloud.
key_nameSpecifies the name for your CMK in Google Cloud.
Optional
optionSie können den folgenden Wert angeben, damit die Option Ihren privaten Konnektivitätsendpunkt für Tri-Secret Secure verwendet:
'TRUE'Gibt an, dass Snowflake den bereitgestellten Konnektivitätsendpunkt für Tri-Secret Secure verwendet.
Wichtig
Wenn Sie keinen Wert für diese Option übergeben, verwendet Snowflake nicht den bereitgestellten Konnektivitätsendpunkt für Tri-Secret Secure.
Bemerkung
Die Option zur Aktivierung privater Konnektivität für Tri-Secret Secure wird nur auf AWS Nur und Azure unterstützt.
Rückgabewerte¶
Returns a status message stating that the registration is complete.
Anforderungen an die Zugriffssteuerung¶
Diese Funktion kann nur von Kontoadministratoren (d. h. Benutzer mit der Rolle ACCOUNTADMIN) ausgeführt werden.
Beispiele¶
Aktivieren Ihres CMK für Ihr Snowflake-Konto auf Amazon Web Services:
SELECT SYSTEM$REGISTER_CMK_INFO('arn:aws:kms:us-west-2:736112632310:key/ceab36e4-f0e5-4b46-9a78-86e8f17a0f59');
Aktivieren Ihres CMK für Ihr Snowflake-Konto auf Microsoft Azure:
SELECT SYSTEM$REGISTER_CMK_INFO('https://trisecretsite.vault.azure.net/', 'trisecretazkey');
Aktivieren Ihres CMK für Ihr Snowflake-Konto auf Google Cloud Platform:
SELECT SYSTEM$REGISTER_CMK_INFO('my-env', 'us-west1', 'trisecrettest', 'trisecretgcpkey');
Register your CMK with a privatelink endpoint for your Snowflake account on Amazon Web Services:
SELECT SYSTEM$REGISTER_CMK_INFO('arn:aws:kms:us-west-2:736112632310:key/ceab36e4-f0e5-4b46-9a78-86e8f17a0f59', 'true');
Register your CMK with a privatelink endpoint for your Snowflake account on Microsoft Azure:
SELECT SYSTEM$REGISTER_CMK_INFO('https://trisecretsite.vault.azure.net/', 'trisecretazkey', 'true');