Sql Server: Desabilitar Identity de coluna (permitir inserir)

Sql Server: Desabilitar Identity de coluna (permitir inserir)

  14 de abril de 2025    henrique

---

 

No SQL Server, uma coluna com a propriedade IDENTITY é usada para gerar valores automáticos de forma incremental para registros inseridos na tabela. Isso é bastante útil quando queremos que a coluna tenha valores exclusivos e sequenciais, como um identificador (ID). No entanto, existem situações em que você pode precisar desabilitar ou essa propriedade de uma coluna já existente.

Para isso, podemos utilizar o comando SET IDENTITY_INSERT.

O que é o IDENTITY_INSERT?

O comando SET IDENTITY_INSERT permite que você insira explicitamente um valor em uma coluna que tenha a propriedade IDENTITY. Normalmente, o SQL Server gerencia automaticamente o valor dessa coluna (incrementando-o a cada inserção), mas em algumas situações, como ao importar dados ou corrigir registros, você pode precisar inserir um valor manualmente nessa coluna.

Quando o IDENTITY_INSERT está ativado para uma tabela, você pode especificar valores para a coluna IDENTITY durante a inserção, e o SQL Server vai aceitar esses valores, em vez de gerá-los automaticamente.

Sintaxe do Comando

A sintaxe básica do comando SET IDENTITY_INSERT é a seguinte:

SET IDENTITY_INSERT <nome_da_tabela> ON;

INSERT INTO <nome_da_tabela> (<coluna1>, <coluna2>, <colunaIDENTITY>, ...)

VALUES (<valor1>, <valor2>, <valorIDENTITY>, ...);

SET IDENTITY_INSERT <nome_da_tabela> OFF;

Explicação linha a linha

1. SET IDENTITY_INSERT <nome_da_tabela> ON;: Ativa a inserção explícita na coluna IDENTITY da tabela.
2. INSERT INTO <nome_da_tabela>: Insere os dados, incluindo valores para a coluna IDENTITY.
3. SET IDENTITY_INSERT <nome_da_tabela> OFF;: Desativa a inserção explícita na coluna IDENTITY.

Cuidados ao Usar o IDENTITY_INSERT

Embora o comando SET IDENTITY_INSERT seja útil em várias situações, existem algumas considerações e cuidados importantes a serem observados:

Limitação por tabela: Você pode ter apenas um IDENTITY_INSERT ativo por vez. Isso significa que, se você tentar ativá-lo em várias tabelas simultaneamente, o SQL Server gerará um erro. Lembre-se de sempre desativar o IDENTITY_INSERT assim que terminar de usá-lo.

Integridade dos dados: Ao inserir manualmente um valor em uma coluna IDENTITY, o valor gerado automaticamente pode não seguir a sequência esperada. Isso pode causar problemas de integridade, como valores duplicados ou faltantes. Por exemplo, se você inserir explicitamente o valor 5, e depois tentar inserir outro valor sem especificar o ClienteID, o próximo valor será gerado automaticamente como 6. Isso pode gerar um gap na sequência de valores da coluna.

Desempenho: Embora o impacto no desempenho geralmente seja pequeno, o uso excessivo de IDENTITY_INSERT pode afetar a geração de índices e aumentar a carga de inserção na tabela. É importante utilizar o comando apenas quando necessário, como ao importar dados ou corrigir registros.

Quando Utilizar o IDENTITY_INSERT?

Aqui estão alguns cenários típicos em que você pode querer usar o comando SET IDENTITY_INSERT:

Importação de dados: Ao migrar dados de uma tabela para outra e preservar os valores existentes da coluna IDENTITY.

Restaurar dados: Durante a restauração ou recuperação de dados de backup, onde você precisa inserir valores manualmente.

Correção de valores: Quando há a necessidade de corrigir valores específicos de IDs em registros existentes, como ao tentar inserir dados com um ID específico ou corrigir falhas na sequência.

Conclusão

O comando SET IDENTITY_INSERT no SQL Server é uma ferramenta poderosa que permite inserir valores manualmente em colunas com a propriedade IDENTITY. Ele é útil em situações como importação de dados, recuperação de dados e correção de registros, mas deve ser usado com cautela para evitar problemas de integridade dos dados e desempenho. Lembre-se sempre de desativar o IDENTITY_INSERT após usá-lo e evite deixá-lo ativado por longos períodos.