Microsoft MVP성태의 닷넷 이야기
닷넷: 2207. C# - SQL Server DB를 bacpac으로 Export/Import [링크 복사], [링크+제목 복사],
조회: 11156
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일

C# - SQL Server DB를 bacpac으로 Export/Import

"Microsoft SSMS(SQL Server Management Studio)"의 기능 중에는 "Export Data-tier Application", "Import Data-tier Application" 메뉴를 이용해 DB를 bacpac 단일 파일로 export/import할 수 있습니다.

Data-tier applications (DAC)
; https://learn.microsoft.com/en-us/sql/relational-databases/data-tier-applications/data-tier-applications

Export to a BACPAC file - Azure SQL Database and Azure SQL Managed Instance
; https://learn.microsoft.com/en-us/azure/azure-sql/database/database-export

Azure 데이터베이스를 로컬 DB로 이전하는 방법
; https://www.sysnet.pe.kr/2/0/1667

재미있는 건, SSMS의 그런 기능들은 대부분 코드로도 가능하다는 점입니다. 실제로 bacpac 처리는 다음의 Q&A에도 그 방법이 나옵니다.

c# create a .bacpac file from ms sql database
; https://stackoverflow.com/questions/37705038/c-sharp-create-a-bacpac-file-from-ms-sql-database

즉, Microsoft.SqlServer.Dac.dll 어셈블리를 이용하면 되는데요, 비주얼 스튜디오를 설치한 경우 "C:\Program Files\Microsoft Visual Studio\2022\Enterprise\Common7\IDE\Extensions\Microsoft\SQLDB\DAC" 디렉터리에서 찾을 수 있습니다. 그런데 NuGet을 보면 동일한 이름의 패키지가 있는데,

// https://www.nuget.org/packages/Microsoft.SqlServer.Dac
Install-Package Microsoft.SqlServer.Dac

"Project website"의 링크가 단순히 learn 문서로 연결되는 것을 봤을 때 마이크로소프트의 공식 계정이 아니고 개인이 임의로 해당 DLL을 말아서 NuGet에 올린 것 같습니다.




bacpac 처리를 간단하게 ^^ 한번 만들어 볼까요?

우선 프로젝트 유형은 .NET Framework 유형으로 해야 합니다. (관련 DLL들이 아직은 .NET Core/5+용으로 빌드되지 않고 있습니다.)

그다음, Microsoft.SqlServer.Dac.dll과 함께 bacpac 처리에 필요한 DLL들은 (테스트로 알아낸 결과) 이렇게 필요합니다. (같은 디렉터리에 있습니다.)

  • Microsoft.Data.SqlClient.dll
  • Microsoft.Data.SqlClient.SNI.x64.dll
  • Microsoft.Data.Tools.Schema.Sql.dll
  • Microsoft.Data.Tools.Utilities.dll
  • Microsoft.Identity.Client.dll
  • Microsoft.SqlServer.Dac.dll
  • Microsoft.SqlServer.TransactSql.ScriptDom.dll
  • System.Memory.dll
  • System.Resources.Extensions.dll
  • System.Runtime.CompilerServices.Unsafe.dll

그중에 Microsoft.Data.SqlClient.SNI.x64.dll은 native 모듈이기 때문에 복사하는 식으로 배포하고, 다른 DLL들만 참조 추가를 하면 됩니다.

  <ItemGroup>
    <Content Include="..\lib\Microsoft.Data.SqlClient.SNI.x64.dll">
      <Link>Microsoft.Data.SqlClient.SNI.x64.dll</Link>
      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    </Content>
  </ItemGroup>

  <ItemGroup>
    <Reference Include="Microsoft.Data.SqlClient">
      <HintPath>..\lib\Microsoft.Data.SqlClient.dll</HintPath>
    </Reference>
    <Reference Include="Microsoft.Data.Tools.Schema.Sql">
      <HintPath>..\lib\Microsoft.Data.Tools.Schema.Sql.dll</HintPath>
    </Reference>
    <Reference Include="Microsoft.Data.Tools.Utilities">
      <HintPath>..\lib\Microsoft.Data.Tools.Utilities.dll</HintPath>
    </Reference>
    <Reference Include="Microsoft.Identity.Client">
      <HintPath>..\lib\Microsoft.Identity.Client.dll</HintPath>
    </Reference>
    <Reference Include="Microsoft.SqlServer.Dac">
      <HintPath>..\lib\Microsoft.SqlServer.Dac.dll</HintPath>
    </Reference>
    <Reference Include="Microsoft.SqlServer.TransactSql.ScriptDom">
      <HintPath>..\lib\Microsoft.SqlServer.TransactSql.ScriptDom.dll</HintPath>
    </Reference>
    <Reference Include="System.Memory, Version=4.0.1.2, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51, processorArchitecture=MSIL">
      <SpecificVersion>False</SpecificVersion>
      <HintPath>..\lib\System.Memory.dll</HintPath>
    </Reference>
    <Reference Include="System.Resources.Extensions">
      <HintPath>..\lib\System.Resources.Extensions.dll</HintPath>
    </Reference>
    <Reference Include="System.Runtime.CompilerServices.Unsafe, Version=6.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a, processorArchitecture=MSIL">
      <SpecificVersion>False</SpecificVersion>
      <HintPath>..\lib\System.Runtime.CompilerServices.Unsafe.dll</HintPath>
    </Reference>
  </ItemGroup>

자, 남은 것은 이제 코딩인데요, bacpack 파일로 export하는 것은 다음과 같이 할 수 있고,

using Microsoft.SqlServer.Dac;
using System;
using System.Data.SqlClient;
using System.IO;

namespace ConsoleApp1;

internal class Program
{
    static int Main(string[] args)
    {
        string infoFilePath = args[0];
        string downloadPath = args[1];

        SqlConnectionStringBuilder csb = new SqlConnectionStringBuilder();

        (string dataSource, string userId, string Password, string dbName) = LoadUserInfo(infoFilePath);

        string timePrefix = DateTime.Now.ToString("yyyy_MM_dd");
        string bacpacFilePath = Path.Combine(downloadPath, $"{dbName}_{timePrefix}.bacpac");

        csb.UserID = userId;
        csb.Password = Password;
        csb.DataSource = dataSource;
        csb.TrustServerCertificate = true;

        DacServices ds = new DacServices(csb.ConnectionString);
        ds.ExportBacpac(bacpacFilePath, dbName);

        Console.WriteLine(bacpacFilePath);

        return 0;
    }

    private static (string dataSource, string userId, string Password, string dbName) LoadUserInfo(string filePath)
    {
        string[] lines = File.ReadAllLines(filePath);
        return (lines[0], lines[1], lines[2], lines[3]);
    }
}

bacpac 파일을 다시 DB로 import하는 것은 다음과 같이 코딩할 수 있습니다.

using Microsoft.SqlServer.Dac;
using System;
using smo = Microsoft.SqlServer.Management.Smo;

namespace ConsoleApp3
{
    // Install-Package Microsoft.SqlServer.SqlManagementObjects 
    internal class Program
    {
        static int Main(string[] args)
        {
            string bacpacFilePath = args[0];
            string dbName = args[1];

            DropDatabaseIfExists(dbName);

            string connectionString = "TrustServerCertificate=true; Integrated Security=SSPI;Persist Security Info=False;Data Source=.";

            BacPackage bp = BacPackage.Load(bacpacFilePath);
            DacServices ds = new DacServices(connectionString);

            ds.ImportBacpac(bp, dbName);

            return 0;
        }

        private static void DropDatabaseIfExists(string dbName)
        {
            var server = new smo.Server(Environment.MachineName);
            smo.Database found = null;
            foreach (smo.Database db in server.Databases)
            {
                if (db.Name.Equals(dbName, StringComparison.InvariantCultureIgnoreCase))
                {
                    found = db;
                    break;
                }
            }

            if (found != null)
            {
                found.Drop();
            }
        }
    }
}




위의 코드를 이용하면 간단한 데이터베이스 백업 시스템을 만드는 것도 가능합니다. 스케줄러에 등록해 하루 단위로 이렇게 실행해 두면,

C:\temp> type c:\temp\db.settings.txt
192.168.100.50,1433
...[DB계정]...
...[비밀번호]...
TESTDB

C:\temp> ExportBacpac "c:\temp\db.settings.txt" c:\temp

192.168.100.50,1433 DB 서버에 접속해 "TESTDB" 데이터베이스를 "c:\temp\TESTDB_2024_01_05.bacpac"과 같은 식의 파일명으로 백업할 수 있습니다.

복원도 이와 유사하게 명령을 내리면 됩니다.

c:\temp> ImportBacpac.exe "C:\temp\TESTDB_2024_01_05.bacpac" TESTDB

그럼 ImportBacpac을 실행하는 localhost에 Windows 통합 계정으로 로그인을 해 TESTDB_2024_01_05.bacpac 파일의 내용을 새롭게 TESTDB 데이터베이스로 복원을 합니다.

간단하죠? ^^ 좀 더 응용해서 위의 과정을 합치는 배치 파일을 만들어 두면,

for /f %%i in ('"c:\temp\ExportBacpac.exe" "C:\temp\db.settings.txt" C:\temp') do set CREATED_FILE_PATH=%%i

echo %CREATED_FILE_PATH% Created!

"c:\temp\ImportBacpac.exe" "%CREATED_FILE_PATH%" TESTDB

매일 특정 DB를 로컬 측으로 동기화하도록 만들 수 있습니다.

(첨부 파일은 이 글의 예제 코드를 포함합니다. 크기를 줄이기 위해 참조한 DLL은 누락시켰습니다.)




[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]







[최초 등록일: ]
[최종 수정일: 1/21/2024]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 작성자
 




... 91  92  93  94  95  96  97  98  99  100  101  [102]  103  104  105  ...
NoWriterDateCnt.TitleFile(s)
11416정성태12/21/201720356.NET Framework: 718. AsyncTaskMethodBuilder.Create() 메서드 동작 방식 [2]
11415정성태12/21/201722228.NET Framework: 717. Task를 포함하지 않는 async 메서드의 동작 방식 [6]
11414정성태12/21/201729315.NET Framework: 716. async 메서드의 void 반환 타입 사용에 대하여파일 다운로드2
11413정성태12/20/201724081개발 환경 구성: 344. 윈도우 10 - TTS 및 음성 인식을 위한 환경 설정
11412정성태12/20/201726662.NET Framework: 715. C# - Windows 10 운영체제의 데스크톱 앱에서 TTS(SpeechSynthesizer) 사용하는 방법 [1]파일 다운로드1
11411정성태12/20/201724819사물인터넷: 15. 라즈베리 파이용 C++ 프로젝트에 SSL Socket 적용
11410정성태12/20/201737221.NET Framework: 714. SSL Socket 예제 - C/C++ 서버, C# 클라이언트 [1]파일 다운로드1
11409정성태12/18/201743340VC++: 122. 오픈 소스 라이브러리를 쉽게 빌드해 주는 "C++ Package Manager for Windows: vcpkg" [7]
11408정성태12/18/201722063.NET Framework: 713. C# - SharpDX + DXGI를 이용한 윈도우 화면 캡처 소스 코드 + Direct2D 출력 + OpenCV (2)파일 다운로드1
11407정성태12/18/201725916.NET Framework: 712. C# - SharpDX + DXGI를 이용한 윈도우 화면 캡처 소스 코드 + Direct2D 출력 + OpenCV [1]파일 다운로드1
11406정성태12/17/201748427.NET Framework: 711. C# - OpenCvSharp의 Mat 데이터 조작 방법 [5]파일 다운로드1
11405정성태12/17/201744664.NET Framework: 710. C# - OpenCvSharp을 이용한 Webcam 영상 처리 + Direct2D [1]파일 다운로드1
11404정성태12/16/201731565.NET Framework: 709. C# - OpenCvSharp을 이용한 동영상(avi, mp4, ...) 처리 + Direct2D [7]파일 다운로드1
11403정성태12/16/201733594.NET Framework: 708. C# - OpenCvSharp을 이용한 동영상(avi, mp4, ...) 처리 [3]파일 다운로드1
11402정성태12/15/201738843.NET Framework: 707. OpenCV 응용 프로그램을 C#으로 구현 - OpenCvSharp [2]파일 다운로드1
11401정성태12/15/201726898.NET Framework: 706. C# - SharpDX + DXGI를 이용한 윈도우 화면 캡처 소스 코드 + Direct2D 출력 [2]파일 다운로드1
11400정성태12/14/201730637.NET Framework: 705. C# - SharpDX + DXGI를 이용한 윈도우 화면 캡처 소스 코드 [9]파일 다운로드1
11399정성태12/13/201719191.NET Framework: 704. Win32 API의 UnionRect를 닷넷 BCL의 Rectangle.Union으로 바꿀 때 주의 사항
11398정성태12/13/201718947오류 유형: 442. ASP.NET Core Web Application (on .NET Framework) 프로젝트에서 외부 라이브러리 동적 로드 시 런타임 버전 문제파일 다운로드1
11397정성태12/12/201721837.NET Framework: 703. 양자 컴퓨팅을 위한 마이크로소프트의 Q# 언어
11396정성태12/8/201744369개발 환경 구성: 343. Visual Studio - 리눅스 용 프로젝트의 인텔리센스를 위한 헤더 파일 처리 방법 [3]
11395정성태12/8/201719629오류 유형: 441. 이벤트 로그 - Time Provider NtpClient: No valid response has been received from domain controller
11394정성태12/8/201719288개발 환경 구성: 342. 비주얼 스튜디오에서 실행하던 ASP.NET Core (.NET Framework) 응용 프로그램을 명령행에서 실행하는 방법
11393정성태12/7/201724318Windows: 145. 윈도우 10 빌드 17046부터 WSL에서 백그라운드 작업 지원 [5]
11392정성태12/7/201718893개발 환경 구성: 341. openSUSE에 닷넷 코어 설치
11391정성태12/7/201721905개발 환경 구성: 340. WSL을 이용해 윈도우 PC 1대에서 openSUSE 응용 프로그램을 Visual Studio로 개발하는 방법 [1]
... 91  92  93  94  95  96  97  98  99  100  101  [102]  103  104  105  ...