Compartilhar via


Alterar o DacFx usado pelo SSDT (SQL Server Data Tools)

Em circunstâncias específicas, talvez seja necessário usar uma versão diferente do DacFx com a interface SQL Server Data Tools em Visual Studio. Quando possível, será recomendável usar uma versão autônoma do DacFx se for necessário usar a versão alternativa do SQL Server Data Tools.

Siga o processo abaixo para alterar a versão do DacFx usada pelo SSDT (SQL Server Data Tools).

Substituir arquivos DacFx no SSDT

O SQL Server Data Tools armazena os arquivos DacFx em Common7\IDE\Extensions\Microsoft\SQLDB\DAC dentro dos arquivos de programa do Visual Studio. Por Visual Studio 2022 Community, o caminho completo é normalmente C:\Program Files\Microsoft Visual Studio\2022\Community\Common7\IDE\Extensions\Microsoft\SQLDB\DAC.

A substituição deve ser feita dentro da mesma versão principal do DacFx. Por exemplo, se o Visual Studio 17.9 (2022) usar a versão 162.2.33.1 do DacFx, somente outras versões 162.x deverão ser usadas. Para exibir a versão atual, selecione o arquivo Microsoft.SqlServer.Dac.dll no Explorador de Arquivos, na pasta DacFx do SSDT, e use o menu de contexto para abrir as propriedades do arquivo.

DacFx é publicado no NuGet. Identifique a versão desejada no feed do NuGet do Microsoft.SqlServer.DacFx e siga estas etapas para usá-la com o SSDT:

  1. Baixe o NuGet para a versão do DacFx na interface da Web.

  2. Altere o arquivo nupkg para um zip e extraia a camada de acesso aos arquivos.

  3. Feche o Visual Studio.

  4. Copie os seguintes arquivos de lib/net462 para a pasta DacFx do SSDT:

    • Microsoft.Data.Tools.Schema.Sql.dll
    • Microsoft.Data.Tools.Utilities.dll
    • Microsoft.SqlServer.Dac.dll
    • Microsoft.SqlServer.Dac.Extensions.dll
    • Microsoft.SqlServer.Dac.Extensions.xml
    • Micrososft.SqlServer.Dac.xml
    • Microsoft.SqlServer.TransactSql.ScriptDom.dll
    • Microsoft.SqlServer.Types.dll

Projetos SQL exigirão Limpeza ou Reconstrução após esse processo de incorporar corretamente a versão substituída do DacFx.