Todos os produtos
Search
Central de documentação

MaxCompute:ROTATE_KEYSET

Última atualização: Aug 20, 2026

Permite que o sistema gere automaticamente uma nova chave e a configure como chave mestra.

Sintaxe

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

Parâmetros

  • keyset: obrigatório. Valor do tipo BINARY. Especifica o keyset que você deseja atualizar.

  • key_type: obrigatório. Define o tipo de algoritmo da nova chave. Valores válidos: AES-GCM-256, AES-SIV-CMAC-128 e AES-SIV-CMAC-256.

  • description: opcional. Fornece uma descrição para a nova chave de dados.

Valor de retorno

Retorna um keyset do tipo BINARY.

Nota

Conforme a necessidade do seu negócio, utilize HEX para converter o tipo BINARY em STRING ou UNHEX para converter o tipo STRING em BINARY.

Exemplos

select ROTATE_KEYSET(unhex ('0A1072384D715A414541385044643351534C12580A330A0B4145532D47434D2D323536122026A8FB1126DF4F5B5DD03C180E6919565D7716CBB291815EFB5BBF30F8BEF9AF1801200210011A1072384D715A414541385044643351534C20022A0B68656C6C6F20776F726C64'), 'AES-SIV-CMAC-256', 'hello world') ;

O resultado retornado é:

+------------+
| _c0        |
+------------+
| =0A=10BVIuZQEAcHHPLfn1=12X=0A3=0A=0BAES-GCM-256=12=20&=A8=FB=11&=DFO[]=D0<=18=0Ei=19V]w=16=CB=B2=91=81^=FB[=BF0=F8=BE=F9=AF=18=01=20=02=10=01=1A=10r8MqZAEA8PDd3QSL=20=02*=0Bhello=20world=12}=0AX=0A=10AES-SIV-CMAC-256=12@=9D=AD=B7=D6=AF=01=B2=9D=CE=C3=02y=A9=DB=E1=17q>'F=DC=F5=EF=FFI=7F=F0w)=95F=07>=9C=EDqn=DF=0E=1E=16bP&=D3=7F>gV=CBl=8AGJCm=93=FF=F9=96=AD=1A=C0=BC=18=01=20=02=10=01=1A=10BVIuZQEAcHHPLfn1=20=02*=0Bhello=20world |
+-----------

Referências

Referências

Descrição

Use keysets

Explica como utilizar as funções de criptografia e descriptografia relacionadas a keysets.

NEW_KEYSET

Documenta a função NEW_KEYSET, usada para criar um keyset com base em um tipo de algoritmo especificado.

ADD_KEY_TO_KEYSET

Detalha a função ADD_KEY_TO_KEYSET, que adiciona uma chave a um keyset e a configura como chave mestra.

KEYSET_TO_JSON

Apresenta a função KEYSET_TO_JSON, responsável por converter um keyset do tipo BINARY em uma string JSON legível para visualização dos detalhes.

KEYSET_FROM_JSON

Descreve a função KEYSET_FROM_JSON, utilizada para transformar um keyset do tipo JSON em um keyset do tipo BINARY.

NEW_WRAPPED_KEYSET

Aborda a função NEW_WRAPPED_KEYSET. Esta função assume o Alibaba Cloud Resource Name (ARN) de uma função com permissão para usar ARNs de chave mestra do cliente (CMK) do Key Management Service (KMS) no MaxCompute e cria um keyset encapsulado. O ARN da função é definido por role_arn e o ARN do CMK do KMS por kms_cmk_arn. Também concede permissão a outras contas Alibaba Cloud para descriptografar o keyset com base em role_chain.

REWRAP_KEYSET

Refere-se à função REWRAP_KEYSET, empregada para criptografar um keyset encapsulado usando uma chave KMS específica.

ROTATE_WRAPPED_KEYSET

Trata da função ROTATE_WRAPPED_KEYSET, que descriptografa um keyset encapsulado, executa a rotação de chaves e utiliza uma nova chave para criptografar dados.

USE_WRAPPED_KEYSET

Explica a função USE_WRAPPED_KEYSET, usada para converter um keyset encapsulado em um keyset básico (parâmetro em funções de criptografia/descriptografia) ou para extrair e salvar informações visando a manutenção futura.

ENHANCED_SYM_ENCRYPT

Documenta a função ENHANCED_SYM_ENCRYPT, destinada a criptografar dados mediante um keyset especificado.

ENHANCED_SYM_DECRYPT

Descreve a função ENHANCED_SYM_DECRYPT, aplicada na descriptografia de dados por meio de um keyset definido.