Używanie programu PowerShell do zaktualizowania schematu synchronizacji w istniejącej grupie synchronizacji

Artykuł
07/31/2023

Ten przykład programu Azure PowerShell aktualizuje schemat synchronizacji w istniejącej grupie synchronizacji usługi SQL Data Sync. Podczas synchronizowania wielu tabel ten skrypt ułatwia wydajnie aktualizowanie schematu synchronizacji. W tym przykładzie przedstawiono użycie skryptu UpdateSyncSchema, który jest dostępny w witrynie GitHub jako UpdateSyncSchema.ps1.

Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto platformy Azure.

Uwaga

W tym artykule użyto modułu Azure Az programu PowerShell, który jest zalecanym modułem programu PowerShell do interakcji z platformą Azure. Aby rozpocząć pracę z modułem Azure PowerShell, zobacz Instalowanie programu Azure PowerShell. Aby dowiedzieć się, jak przeprowadzić migrację do modułu Az PowerShell, zobacz Migracja programu Azure PowerShell z modułu AzureRM do modułu Az.

Używanie usługi Azure Cloud Shell

Na platforma Azure hostowane jest Azure Cloud Shell, interaktywne środowisko powłoki, z którego można korzystać w przeglądarce. Do pracy z usługami platformy Azure można używać programu Bash lub PowerShell w środowisku Cloud Shell. Aby uruchomić kod w tym artykule, możesz użyć wstępnie zainstalowanych poleceń usługi Cloud Shell bez konieczności instalowania niczego w środowisku lokalnym.

Aby uruchomić środowisko Azure Cloud Shell:

Opcja	Przykład/link
Wybierz pozycję Wypróbuj w prawym górnym rogu bloku kodu. Wybranie pozycji Wypróbuj nie spowoduje automatycznego skopiowania kodu do środowiska Cloud Shell.
Przejdź do witryny https://shell.azure.com lub wybierz przycisk Uruchom Cloud Shell, aby otworzyć środowisko Cloud Shell w przeglądarce.
Wybierz przycisk Cloud Shell na pasku menu w prawym górnym rogu witryny Azure Portal.

Aby uruchomić kod z tego artykułu w środowisku Azure Cloud Shell:

Uruchom usługę Cloud Shell.
Wybierz przycisk Kopiuj w bloku kodu, aby skopiować kod.
Wklej kod do sesji usługi Cloud Shell, wybierając klawisze Ctrl+Shift+V w systemach Windows i Linux lub wybierając pozycję Cmd+Shift+V w systemie macOS.
Naciśnij klawisz Enter, aby uruchomić kod.

Jeśli zdecydujesz się zainstalować program PowerShell i używać go lokalnie, ten samouczek wymaga modułu Az PowerShell 1.4.0 lub nowszego. Jeśli konieczne będzie uaktualnienie, zobacz Instalowanie modułu Azure PowerShell. Jeśli używasz programu PowerShell lokalnie, musisz też uruchomić polecenie Connect-AzAccount, aby utworzyć połączenie z platformą Azure.

Omówienie usługi SQL Data Sync zawiera temat Sync data across multiple cloud and on-premises databases with Azure SQL Data Sync (Synchronizowanie danych między wieloma bazami danych w chmurze i lokalnie za pomocą usługi Azure SQL Data Sync).

Ważne

Usługa SQL Data Sync nie obsługuje obecnie usługi Azure SQL Managed Instance.

Przykłady

Dodawanie wszystkich tabel do schematu synchronizacji

Poniższy przykład służy do odświeżania schematu bazy danych i dodawania wszystkich prawidłowych tabel w bazie danych centrum do schematu synchronizacji.

UpdateSyncSchema.ps1 -SubscriptionId <subscriptionId> -ResourceGroupName <resourceGroupName> -ServerName <serverName> -DatabaseName <databaseName> `
    -SyncGroupName <syncGroupName> -RefreshDatabaseSchema $true -AddAllTables $true

Dodawanie i usuwanie tabel i kolumn

Poniższy przykład służy do dodawania tabel [dbo].[Table1] i [dbo].[Table2].[Column1] do schematu synchronizacji oraz usuwania tabeli [dbo].[Table3].

UpdateSyncSchema.ps1 -SubscriptionId <subscriptionId> -ResourceGroupName <resourceGroupName> -ServerName <serverName> -DatabaseName <databaseName> `
    -SyncGroupName <syncGroupName> -TablesAndColumnsToAdd "[dbo].[Table1],[dbo].[Table2].[Column1]" -TablesAndColumnsToRemove "[dbo].[Table3]"

Parametry skryptu

Skrypt UpdateSyncSchema ma następujące parametry:

Parametr	Uwagi
$subscriptionId	Subskrypcja, w ramach której tworzona jest grupa synchronizacji.
$resourceGroupName	Grupa zasobów, w ramach której tworzona jest grupa synchronizacji.
$serverName	Nazwa serwera bazy danych centrum.
$databaseName	Nazwa bazy danych centrum.
$syncGroupName	Nazwa grupy synchronizacji.
$memberName	Określ nazwę elementu członkowskiego, jeśli schemat bazy danych ma zostać załadowany z elementu członkowskiego synchronizacji zamiast z bazy danych centrum. Jeśli schemat bazy danych ma zostać załadowany z centrum, pozostaw ten parametr pusty.
$timeoutInSeconds	Limit czasu odświeżania schematu bazy danych przez skrypt. Wartość domyślna to 900 sekund.
$refreshDatabaseSchema	Określ, czy skrypt ma odświeżać schemat bazy danych. Jeśli schemat bazy danych został zmieniony z poprzedniej konfiguracji (na przykład w przypadku dodania nowej tabeli lub nowej kolumny), przed ponownym skonfigurowaniem schematu należy odświeżyć. Wartość domyślna to „fałsz”.
$addAllTables	Jeśli ta wartość to true, wszystkie prawidłowe tabele i kolumny zostaną dodane do schematu synchronizacji. Wartości parametrów $TablesAndColumnsToAdd i $TablesAndColumnsToRemove są ignorowane.
$tablesAndColumnsToAdd	Określ tabelę lub kolumny do dodania do schematu synchronizacji. Wszystkie nazwy tabel lub kolumn muszą być w pełni rozdzielone od nazwy schematu. Przykład: `[dbo].[Table1]`, `[dbo].[Table2].[Column1]`. Wiele nazw tabel lub kolumn można określić i rozdzielić przecinkami (,).
$tablesAndColumnsToRemove	Określ tabele lub kolumny do usunięcia ze schematu synchronizacji. Wszystkie nazwy tabel lub kolumn muszą być w pełni rozdzielone od nazwy schematu. Przykład: `[dbo].[Table1]`, `[dbo].[Table2].[Column1]`. Wiele nazw tabel lub kolumn można określić i rozdzielić przecinkami (,).

Objaśnienia dla skryptu

Skrypt UpdateSyncSchema używa następujących poleceń. Każde polecenie w tabeli stanowi link do dokumentacji polecenia.

Polecenie	Uwagi
Get-AzSqlSyncGroup	Zwraca informacje o grupie synchronizacji.
Update-AzSqlSyncGroup	Aktualizuje grupę synchronizacji.
Get-AzSqlSyncMember	Zwraca informacje o elemencie członkowskim synchronizacji.
Get-AzSqlSyncSchema	Zwraca informacje o schemacie synchronizacji.
Update-AzSqlSyncSchema	Aktualizuje schemat synchronizacji.

Następne kroki

Aby uzyskać więcej informacji na temat programu Azure PowerShell, zobacz dokumentację programu Azure PowerShell.

Więcej przykładowych skryptów programu PowerShell dla usługi SQL Database można znaleźć w skryptach programu PowerShell dla usługi Azure SQL Database.

Aby uzyskać więcej informacji na temat usługi SQL Data Sync, zobacz:

Omówienie — synchronizowanie danych między usługą Azure SQL Database i programem SQL Server przy użyciu usługi SQL Data Sync na platformie Azure
Konfigurowanie usługi Data Sync
- Korzystanie z witryny Azure Portal — samouczek: konfigurowanie usługi SQL Data Sync w celu synchronizowania danych między usługą Azure SQL Database i programem SQL Server
- Korzystanie z programu PowerShell
  - Synchronizowanie danych między wieloma bazami danych w usłudze Azure SQL Database za pomocą programu PowerShell
  - Synchronizowanie danych między usługą Azure SQL Database i programem SQL Server przy użyciu programu PowerShell
Agent usługi Data Sync — agent synchronizacji danych dla usługi SQL Data Sync na platformie Azure
Najlepsze rozwiązania — najlepsze rozwiązania dotyczące usługi SQL Data Sync na platformie Azure
Monitorowanie — monitorowanie usługi SQL Data Sync za pomocą dzienników usługi Azure Monitor
Rozwiązywanie problemów — rozwiązywanie problemów z usługą SQL Data Sync na platformie Azure
Aktualizowanie schematu synchronizacji
- Korzystanie z języka Transact-SQL — automatyzowanie replikacji zmian schematu w usłudze SQL Data Sync na platformie Azure

Aby uzyskać więcej informacji na temat usługi SQL Database, zobacz: