ADD_KEY_TO_KEYSET - MaxCompute: Central de Documentação do Alibaba Cloud

Sintaxe

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

Parâmetros

keyset: obrigatório. Especifica um keyset existente do tipo BINARY.
key_type: obrigatório. Especifica o tipo de algoritmo da chave que você deseja adicionar. Valores válidos: AES-GCM-256, AES-SIV-CMAC-128 e AES-SIV-CMAC-256.
raw_key: obrigatório. Especifica a chave que você deseja adicionar e configurar como chave mestra. A chave é do tipo BINARY.
description: opcional. Fornece uma descrição da chave de dados.

Valor de retorno

Retorna um keyset do tipo BINARY.

Nota

Você pode usar HEX para converter o tipo BINARY no tipo STRING ou usar UNHEX para converter o tipo STRING no tipo BINARY, conforme os requisitos de negócio.

Exemplos

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

O resultado retornado é o seguinte:

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

Referências

Referências	Descrição
Usar keysets	Descreve como usar as funções de criptografia e descriptografia relacionadas a keysets.
NEW_KEYSET	Descreve a função NEW_KEYSET. Essa função é usada para criar um keyset com base em um tipo de algoritmo especificado.
KEYSET_TO_JSON	Descreve a função KEYSET_TO_JSON. Essa função converte um keyset do tipo BINARY em uma string JSON legível. Após a conversão, você pode visualizar os detalhes do keyset.
KEYSET_FROM_JSON	Descreve a função KEYSET_FROM_JSON. Essa função converte um keyset do tipo JSON em um keyset do tipo BINARY.
ROTATE_KEYSET	Descreve a função ROTATE_KEYSET. Essa função permite que o sistema produza automaticamente uma nova chave e a configure como chave mestra.
NEW_WRAPPED_KEYSET	Descreve a função NEW_WRAPPED_KEYSET. Essa função é usada para assumir o Alibaba Cloud Resource Name (ARN) de uma função que pode usar os ARNs de chave mestra do cliente (CMK) do Key Management Service (KMS) para o MaxCompute e criar um keyset encapsulado. O ARN da função é especificado por `role_arn`. O ARN do CMK do KMS é especificado por kms_cmk_arn. A função também é usada para conceder a outras contas da Alibaba Cloud as permissões para descriptografar um keyset com base em `role_chain`.
REWRAP_KEYSET	Descreve a função REWRAP_KEYSET. Essa função é usada para criptografar novamente um keyset encapsulado com base em uma chave do KMS especificada.
ROTATE_WRAPPED_KEYSET	Descreve a função ROTATE_WRAPPED_KEYSET. Essa função é usada para descriptografar um keyset criptografado, implementar a rotação de chaves e usar uma nova chave para criptografar dados.
USE_WRAPPED_KEYSET	Descreve a função USE_WRAPPED_KEYSET. Essa função converte um keyset encapsulado em um keyset básico, usado como parâmetro na função de criptografia ou descriptografia. Você também pode usar a função USE_WRAPPED_KEYSET para obter informações sobre um keyset encapsulado e salvar essas informações para a manutenção subsequente do keyset.
ENHANCED_SYM_ENCRYPT	Descreve a função ENHANCED_SYM_ENCRYPT. Essa função é usada para criptografar dados usando um keyset especificado.
ENHANCED_SYM_DECRYPT	Descreve a função ENHANCED_SYM_DECRYPT. Essa função é usada para descriptografar dados usando um keyset especificado.