ADD_KEY_TO_KEYSET - MaxCompute - Alibaba Cloud ドキュメントセンター

キーセットにキーを追加し、そのキーをマスターキーとして設定します。

構文

binary ADD_KEY_TO_KEYSET(binary <keyset>, string <key_type>, binary <raw_key>, [string <description>])

Parameters

keyset: 必須です。このパラメーターには、BINARY型の既存のキーセットを指定します。
key_type: 必須です。このパラメーターには、追加するキーのアルゴリズムタイプを指定します。有効な値: AES-GCM-256、AES-SIV-CMAC-128、およびAES-SIV-CMAC-256。
raw_key: 必須です。このパラメーターには、マスターキーとして追加および構成するキーを指定します。キーはBINARYタイプです。
description: オプション。このパラメーターは、データキーの説明を提供します。

戻り値

BINARY型のキーセットが返されます。

説明

ビジネス要件に基づいて、HEXを使用してBINARY型をSTRING型に変換したり、UNHEXを使用してSTRING型をBINARY型に変換したりできます。

例

select hex(ADD_KEY_TO_KEYSET(unhex ('0A1072384D715A414541385044643351534C12580A330A0B4145532D47434D2D323536122026A8FB1126DF4F5B5DD03C180E6919565D7716CBB291815EFB5BBF30F8BEF9AF1801200210011A1072384D715A414541385044643351534C20022A0B68656C6C6F20776F726C64'), 'AES-SIV-CMAC-128', unhex('b75585cf321cdcad42451690cdb7bfc49c26092f60f854e72d43244c55620a3d'),'description') );

次の応答が返されます。

+------------+
| _c0        |
+------------+
| 0A10596530735A5145414150447273424C4212580A330A0B4145532D47434D2D323536122026A8FB1126DF4F5B5DD03C180E6919565D7716CBB291815EFB5BBF30F8BEF9AF1801200210011A1072384D715A414541385044643351534C20022A0B68656C6C6F20776F726C64125D0A380A104145532D5349562D434D41432D3132381220B75585CF321CDCAD42451690CDB7BFC49C26092F60F854E72D43244C55620A3D1801200110011A10596530735A5145414150447273424C4220022A0B6465736372697074696F6E |
+------------+

関連ドキュメント

関連ドキュメント	説明
キーセットの使用	キーセット関連の暗号化および復号化関数の使用方法について説明します。
NEW_キーセット	NEW_KEYSET関数について説明します。この関数は、指定されたアルゴリズムタイプに基づいてキーセットを作成するために使用されます。
KEYSET_TO_JSON	KEYSET_TO_JSON関数について説明します。この関数は、BINARY型のキーセットを読み取り可能なJSON文字列に変換するために使用されます。変換後、キーセットの詳細を表示できます。
KEYSET_FROM_JSON	KEYSET_FROM_JSON関数について説明します。この関数は、JSON型のキーセットをBINARY型のキーセットに変換するために使用されます。
ROTATE_KEYSET	ROTATE_KEYSET関数について説明します。この機能により、システムは自動的に新しいキーを生成し、新しいキーをマスターキーとして構成することができます。
NEW_WRAPPED_KEYSET	NEW_WRAPPED_KEYSET関数について説明します。この関数は、Key Management Service (KMS) カスタマーマスターキー (CMK) ARNをMaxComputeに使用できるロールのAlibaba Cloud Resource Name (ARN) を引き受け、ラップされたキーセットを作成するために使用されます。ロールARNは、`role_arn`によって指定される。 KMS CMK ARNは、kms_cmk_arnによって指定される。この関数は、`role_chain`に基づいてキーセットを復号化する権限を他のAlibaba Cloudアカウントに付与するためにも使用されます。
REWRAP_キーセット	REWRAP_KEYSET関数について説明します。この関数は、指定されたKMSキーに基づいてラップされたキーセットを再暗号化するために使用されます。
ROTATE_WRAPPED_KEYSET	ROTATE_WRAPPED_KEYSET関数について説明します。この関数は、暗号化されたキーセットを復号し、キーローテーションを実装し、新しいキーを使用してデータを暗号化するために使用されます。
USE_WRAPPED_キーセット	USE_WRAPPED_KEYSET関数について説明します。この関数は、ラップされたキーセットを、暗号化または復号化関数のパラメータとして使用される基本キーセットに変換するために使用されます。 USE_WRAPPED_KEYSET関数を使用して、ラップされたキーセットに関する情報を取得し、その後のキーセットのメンテナンスのために情報を保存することもできます。
ENHANCED_SYM_ENCRYPT	ENHANCED_SYM_ENCRYPT関数について説明します。この関数は、指定されたキーセットを使用してデータを暗号化します。
ENHANCED_SYM_DECRYPT	ENHANCED_SYM_DECRYPT関数について説明します。この関数は、指定されたキーセットを使用してデータを復号します。