Använd PowerShell för att uppdatera synkroniseringsschemat i en befintlig synkroniseringsgrupp
Gäller för:
Azure SQL Database
Det här Azure PowerShell-exemplet uppdaterar synkroniseringsschemat i en befintlig SQL Data Sync-synkroniseringsgrupp. När du synkroniserar flera tabeller får du hjälp av det här skriptet att uppdatera synkroniseringsschemat på ett effektivt sätt. Det här exemplet visar hur skriptet UpdateSyncSchema används. Det finns på GitHub som UpdateSyncSchema.ps1.
Om du inte har en Azure-prenumeration skapar du ett kostnadsfritt Azure-konto innan du börjar.
Kommentar
Den här artikeln använder Azure Az PowerShell-modulen, som är den rekommenderade PowerShell-modulen för interaktion med Azure. För att komma igång med Az PowerShell kan du läsa artikeln om att installera Azure PowerShell. Information om hur du migrerar till Az PowerShell-modulen finns i artikeln om att migrera Azure PowerShell från AzureRM till Az.
Använda Azure Cloud Shell
Azure är värd för Azure Cloud Shell, en interaktiv gränssnittsmiljö som du kan använda via webbläsaren. Du kan använda antingen Bash eller PowerShell med Cloud Shell för att arbeta med Azure-tjänster. Du kan använda förinstallerade Cloud Shell-kommandon för att köra koden i den här artikeln, utan att behöva installera något i din lokala miljö.
Så här startar du Azure Cloud Shell:
| Alternativ | Exempel/länk |
|---|---|
| Välj Prova i det övre högra hörnet av ett kodblock. Om du väljer Prova kopieras koden inte automatiskt till Cloud Shell. |  |
| Gå till https://shell.azure.com eller Välj knappen Starta Cloud Shell för att öppna Cloud Shell i webbläsaren. |  |
| Välj knappen Cloud Shell på menyn längst upp till höger i Azure-portalen. |  |
Så här kör du koden i den här artikeln i Azure Cloud Shell:
Starta Cloud Shell.
Kopiera koden genom att klicka på knappen Kopiera på ett kodblock.
Klistra in koden i Cloud Shell-sessionen genom att välja Ctrl+Skift+V i Windows och Linux, eller genom att välja Cmd+Shift+V på macOS.
Välj Retur för att köra koden.
Om du väljer att installera och använda PowerShell lokalt kräver den här självstudien Az PowerShell 1.4.0 eller senare. Om du behöver uppgradera kan du läsa Install Azure PowerShell module (Installera Azure PowerShell-modul). Om du kör PowerShell lokalt måste du också köra Connect-AzAccount för att skapa en anslutning till Azure.
En översikt över SQL Data Sync finns i Synkronisera data i flera moln och lokala databaser med Azure SQL Data Sync.
Viktigt!
SQL Data Sync stöder för närvarande inte Azure SQL Managed Instance.
Exempel
Lägga till alla tabeller i synkroniseringsschemat
I följande exempel uppdateras databasschemat och alla giltiga tabeller läggs till i synkroniseringsschemat i hubbdatabasen.
UpdateSyncSchema.ps1 -SubscriptionId <subscriptionId> -ResourceGroupName <resourceGroupName> -ServerName <serverName> -DatabaseName <databaseName> `
-SyncGroupName <syncGroupName> -RefreshDatabaseSchema $true -AddAllTables $true
Lägga till och ta bort tabeller och kolumner
I följande exempel läggs [dbo].[Table1] och [dbo].[Table2].[Column1] till i synkroniseringsschemas, och [dbo].[Table3] tas bort.
UpdateSyncSchema.ps1 -SubscriptionId <subscriptionId> -ResourceGroupName <resourceGroupName> -ServerName <serverName> -DatabaseName <databaseName> `
-SyncGroupName <syncGroupName> -TablesAndColumnsToAdd "[dbo].[Table1],[dbo].[Table2].[Column1]" -TablesAndColumnsToRemove "[dbo].[Table3]"
Skriptparametrar
Skriptet UpdateSyncSchema innehåller följande parametrar:
| Parameter | Anteckningar |
|---|---|
| $subscriptionId | Den prenumeration där synkroniseringsgruppen skapas. |
| $resourceGroupName | Den resursgrupp där synkroniseringsgruppen skapas. |
| $serverName | Hubbdatabasens servernamn. |
| $databaseName | Hubbdatabasens namn. |
| $syncGroupName | Synkroniseringsgruppens namn. |
| $memberName | Ange medlemsnamnet om du vill läsa in databasschemat från synkroniseringsmedlemmen i stället för från hubbdatabasen. Lämna den här parametern tom om du vill läsa in databasschemat från hubben. |
| $timeoutInSeconds | Tidsgräns när skriptet uppdaterar databasschemat. Standardvärdet är 900 sekunder. |
| $refreshDatabaseSchema | Ange om skriptet behöver uppdatera databasschemat. Om databasschemat har ändrats från den tidigare konfigurationen (till exempel om du har lagt till en ny tabell eller en ny kolumn) måste du uppdatera schemat innan du konfigurerar om det. Standardvärdet är falskt. |
| $addAllTables | Om värdet är true läggs alla giltiga tabeller och kolumner till i synkroniseringsschemat. Värdena för $TablesAndColumnsToAdd och $TablesAndColumnsToRemove ignoreras. |
| $tablesAndColumnsToAdd | Ange tabeller eller kolumner som ska läggas till i synkroniseringsschemat. Alla tabell- och kolumnnamn måste vara helt avgränsade med schemanamnet. Exempel: [dbo].[Table1], [dbo].[Table2].[Column1]. Flera tabell- eller kolumnnamn kan anges och avgränsas med kommatecken (,). |
| $tablesAndColumnsToRemove | Ange tabeller eller kolumner som ska tas bort från synkroniseringsschemat. Alla tabell- och kolumnnamn måste vara helt avgränsade med schemanamnet. Exempel: [dbo].[Table1], [dbo].[Table2].[Column1]. Flera tabell- eller kolumnnamn kan anges och avgränsas med kommatecken (,). |
Förklaring av skript
Skriptet UpdateSyncSchema använder följande parametrar. Varje kommando i tabellen länkar till kommandospecifik dokumentation.
| Command | Anteckningar |
|---|---|
| Get-AzSqlSyncGroup | Returnerar information om en synkroniseringsgrupp. |
| Update-AzSqlSyncGroup | Uppdaterar en synkroniseringsgrupp. |
| Get-AzSqlSyncMember | Returnerar information om en synkroniseringsmedlem. |
| Get-AzSqlSyncSchema | Returnerar information om ett synkroniseringsschema. |
| Update-AzSqlSyncSchema | Uppdaterar ett synkroniseringsschema. |
Nästa steg
Mer information om Azure PowerShell finns i Azure PowerShell-dokumentationen.
Ytterligare PowerShell-skriptexempel för SQL Database finns i PowerShell-skript för Azure SQL Database.
Mer information om SQL Data Sync finns i:
- Översikt – Synkronisera data mellan Azure SQL Database och SQL Server med SQL Data Sync i Azure
- Konfigurera datasynkronisering
- Använda Azure-portalen – Självstudie: Konfigurera SQL Data Sync för att synkronisera data mellan Azure SQL Database och SQL Server
- Använda PowerShell
- Data Sync Agent – Data Sync Agent för SQL Data Sync i Azure
- Metodtips – Metodtips för SQL Data Sync i Azure
- Övervaka – Övervaka SQL Data Sync med Azure Monitor-loggar
- Felsökning – Felsöka problem med SQL Data Sync i Azure
- Uppdatera synkroniseringsschemat
- Använda Transact-SQL – Automatisera replikering av schemaändringar i SQL Data Sync i Azure
Mer information om SQL Database finns i: