Partilhar via


Elemento SetEncryptionKey (XMLA)

Redefine ou atualiza a chave de criptografia da instância MicrosoftSQL ServerAnalysis Services.

Sintaxe

<Command>
   <SetEncryptionKey Reset="boolean">
      <Key>...</Key>
   </SetEncryptionKey>
</Command>

Características do elemento

Característica

Descrição

Tipo de dados e comprimento

Cadeia de caracteres

Valor padrão

Nenhum

Cardinalidade

0-n: elemento opcional que pode ocorrer mais de uma vez.

Relações do elemento

Relação

Elemento

Elementos pai

Command

Elementos filho

Key

Atributos

Atributo

Descrição

Redefinir

Atributo Boolean opcional. Se estiver definida como True, a chave de criptografia será redefinida e o conteúdo do elemento EncryptionKey será ignorado. Caso contrário, o elemento EncryptionKey deverá conter uma chave de criptografia válida.

Comentários

O comando SetEncryptionKey redefine ou atualiza a chave de criptografia de instância de uma instância Analysis Services.

Quando uma instância Analysis Services é instalada primeiro, uma chave de criptografia é definida para aquela instância. A chave de criptografia da instância baseia-se nas credenciais de segurança da conta de usuário do Windows fornecida para a Analysis Services durante a instalação e só pode ser decodificada usando as mesmas credenciais de segurança.

Quando um banco de dados Analysis Services é criado na instância Analysis Services, a instância cria uma chave de criptografia de banco de dados. A chave de criptografia de banco de dados é usada para codificar e decodificar segredos do banco de dados, como, por exemplo, as credenciais de segurança usadas para conectar às fontes de dados definidas na base de dados. A instância usa a chave de criptografia de instância para criptografar a chave de criptografia de banco de dados.

Se a instância Analysis Services não puder mais decodificar a chave de criptografia da instância, os dados e os metadados dessa instância permanecerão inacessíveis. Existem várias situações em que a instância não poderá decodificar a chave de criptografia de instância:

  • A conta de usuário do Windows foi alterada com relação à instância Analysis Services usando um método ou utilitário diferente do Gerenciador de Configurações SQL Server, como o SCM (Gerenciador de Controle de Serviços).

  • A conta de usuário do Windows especificada para a instância Analysis Services não é mais válida.

  • Uma falha do computador que executa a instância Analysis Services requer que a pasta de dados seja transferida para outro computador.

O método SetEncryptionKey pode alterar a chave de criptografia de instância existente para uma chave de criptografia especificada na propriedade Key do comando ou para uma chave de criptografia gerada pelo sistema criada pela propriedade Reset do comando definida como True.

Observação sobre segurançaObservação sobre segurança

Este comando só pode ser executado pelos administradores do servidor.