PowerShell을 사용하여 기존 동기화 그룹의 동기화 스키마 업데이트
적용 대상: 
Azure SQL Database
Important
SQL 데이터 동기화는 2027년 9월 30일에 종료됩니다. 대체 데이터 복제/동기화 솔루션으로 마이그레이션하는 것이 좋습니다.
이 Azure PowerShell 예제에서는 기존 SQL 데이터 동기화 동기화 그룹의 동기화 스키마를 업데이트합니다. 여러 테이블을 동기화하는 경우 이 스크립트를 사용하면 동기화 스키마를 효율적으로 업데이트할 수 있습니다. 이 예제에서는 GitHub에서 UpdateSyncSchema.ps1로 사용할 수 있는 UpdateSyncSchema 스크립트를 사용하는 방법을 보여 줍니다.
Azure를 구독하고 있지 않다면 시작하기 전에 Azure 체험 계정을 만듭니다.
참고
이 문서에서는 Azure와 상호 작용하는 데 권장되는 PowerShell 모듈인 Azure Az PowerShell 모듈을 사용합니다. Az PowerShell 모듈을 시작하려면 Azure PowerShell 설치를 참조하세요. Az PowerShell 모듈로 마이그레이션하는 방법에 대한 자세한 내용은 Azure PowerShell을 AzureRM에서 Azure로 마이그레이션을 참조하세요.
Azure Cloud Shell 사용
Azure는 브라우저를 통해 사용할 수 있는 대화형 셸 환경인 Azure Cloud Shell을 호스트합니다. Cloud Shell에서 Bash 또는 PowerShell을 사용하여 Azure 서비스 작업을 수행할 수 있습니다. 로컬 환경에 아무 것도 설치할 필요 없이 Azure Cloud Shell의 미리 설치된 명령을 사용하여 이 문서의 코드를 실행할 수 있습니다.
Azure Cloud Shell을 시작하려면 다음을 수행합니다.
| 옵션 | 예제/링크 |
|---|---|
| 코드 블록의 오른쪽 위 모서리에서 사용을 선택합니다. 사용해보기를 선택하면 코드가 Cloud Shell에 자동으로 복사되지 않습니다. |  |
| https://shell.azure.com으로 이동하거나 Cloud Shell 시작 단추를 선택하여 브라우저에서 Cloud Shell을 엽니다. |  |
| Azure Portal의 오른쪽 위에 있는 메뉴 모음에서 Cloud Shell 단추를 선택합니다. |  |
이 문서의 코드를 Azure Cloud Shell에서 실행하려면 다음을 수행합니다.
Cloud Shell을 시작합니다.
코드 블록의 복사 단추를 선택하여 코드를 복사합니다.
Windows 및 Linux에서 Ctrl+Shift+V를 선택하거나 macOS에서 Cmd+Shift+V를 선택하여 코드를 Cloud Shell 세션에 붙여넣습니다.
Enter를 선택하여 코드를 실행합니다.
PowerShell을 로컬로 설치하고 사용하도록 선택하는 경우 이 자습서에는 Az PowerShell 1.4.0 이상이 필요합니다. 업그레이드해야 하는 경우 Azure PowerShell 모듈 설치를 참조하세요. 또한 PowerShell을 로컬로 실행하는 경우 Connect-AzAccount를 실행하여 Azure와 연결해야 합니다.
SQL 데이터 동기화의 개요는 Azure의 SQL 데이터 동기화란?을 참조하세요.
SQL 데이터 동기화는 Azure SQL Managed Instance 및 Azure Synapse Analytics를 지원하지 않습니다.
예제
동기화 스키마에 모든 테이블 추가
다음 예제에서는 데이터베이스 스키마를 새로 고치고 허브 데이터베이스의 유효한 모든 테이블을 동기화 스키마에 추가합니다.
UpdateSyncSchema.ps1 -SubscriptionId <subscriptionId> -ResourceGroupName <resourceGroupName> -ServerName <serverName> -DatabaseName <databaseName> `
-SyncGroupName <syncGroupName> -RefreshDatabaseSchema $true -AddAllTables $true
테이블과 열 추가 및 제거
다음 예제에서는 동기화 스키마에 [dbo].[Table1] 및 [dbo].[Table2].[Column1]를 추가하고 [dbo].[Table3]을 제거합니다.
UpdateSyncSchema.ps1 -SubscriptionId <subscriptionId> -ResourceGroupName <resourceGroupName> -ServerName <serverName> -DatabaseName <databaseName> `
-SyncGroupName <syncGroupName> -TablesAndColumnsToAdd "[dbo].[Table1],[dbo].[Table2].[Column1]" -TablesAndColumnsToRemove "[dbo].[Table3]"
스크립트 매개 변수
UpdateSyncSchema 스크립트에는 다음과 같은 매개 변수가 있습니다.
| 매개 변수 | 메모 |
|---|---|
| $subscriptionId | 동기화 그룹이 생성되는 구독입니다. |
| $resourceGroupName | 동기화 그룹이 만들어지는 리소스 그룹입니다. |
| $serverName | 허브 데이터베이스의 서버 이름입니다. |
| $databaseName | 허브 데이터베이스 이름입니다. |
| $syncGroupName | 동기화 그룹 이름입니다. |
| $memberName | 허브 데이터베이스 대신, 동기화 멤버에서 데이터베이스 스키마를 로드하려는 경우 멤버 이름을 지정합니다. 허브에서 데이터베이스 스키마를 로드하려면 이 매개 변수를 비워 둡니다. |
| $timeoutInSeconds | 스크립트가 데이터베이스 스키마를 새로 고치는 경우의 시간 제한입니다. 기본값은 900초입니다. |
| $refreshDatabaseSchema | 스크립트에서 데이터베이스 스키마를 새로 고쳐야 하는지 여부를 지정합니다. 데이터베이스 스키마가 이전 구성에서 변경된 경우(예를 들어 새 테이블이나 새 열을 추가한 경우) 다시 구성하기 전에 스키마를 새로 고쳐야 합니다. 기본값은 false입니다. |
| $addAllTables | 이 값이 true이면 모든 유효한 테이블 및 열이 동기화 스키마에 추가됩니다. $TablesAndColumnsToAdd 및 $TablesAndColumnsToRemove 값은 무시됩니다. |
| $tablesAndColumnsToAdd | 동기화 스키마에 추가할 테이블 또는 열을 지정합니다. 각 테이블 또는 열 이름은 스키마 이름과 완전히 구분되어야 합니다. 예: [dbo].[Table1], [dbo].[Table2].[Column1]. 여러 테이블 또는 열 이름은 쉼표(,)로 구분해서 지정할 수 있습니다. |
| $tablesAndColumnsToRemove | 동기화 스키마에서 제거할 테이블 또는 열을 지정합니다. 각 테이블 또는 열 이름은 스키마 이름과 완전히 구분되어야 합니다. 예: [dbo].[Table1], [dbo].[Table2].[Column1]. 여러 테이블 또는 열 이름은 쉼표(,)로 구분해서 지정할 수 있습니다. |
스크립트 설명
UpdateSyncSchema 스크립트는 다음 명령을 사용합니다. 표에 있는 각 명령은 명령에 해당하는 문서에 연결됩니다.
| 명령 | 주의 |
|---|---|
| Get-AzSqlSyncGroup | 동기화 그룹에 대한 정보를 반환합니다. |
| Update-AzSqlSyncGroup | 동기화 그룹을 업데이트합니다. |
| Get-AzSqlSyncMember | 동기화 구성원에 대한 정보를 반환합니다. |
| Get-AzSqlSyncSchema | 동기화 스키마에 대한 정보를 반환합니다. |
| Update-AzSqlSyncSchema | 동기화 스키마를 업데이트합니다. |
관련 콘텐츠
Azure PowerShell에 대한 자세한 내용은 Azure PowerShell 설명서를 참조하세요.
추가 SQL Database PowerShell 스크립트 샘플은 Azure SQL 데이터베이스 PowerShell 스크립트에 있습니다.
SQL 데이터 동기화에 대한 자세한 내용은 다음을 참조하세요.
- 개요 - Azure의 SQL 데이터 동기화를 사용하여 Azure SQL Database 및 SQL Server 간 데이터 동기화
- 데이터 동기화 설정
- Data Sync Agent - Azure의 SQL 데이터 동기화용 Data Sync Agent
- 모범 사례 - Azure의 SQL 데이터 동기화 모범 사례
- 모니터 - Azure Monitor 로그를 사용하여 SQL 데이터 동기화 모니터링
- 문제 해결 - Azure의 SQL 데이터 동기화 문제 해결
- 동기화 스키마 업데이트
- Transact-SQL 사용 - Azure의 SQL 데이터 동기화에서 스키마 변경 내용 복제 자동화
SQL Database에 대한 자세한 내용은 다음을 참조하세요.