Eseguire la migrazione dei database esistenti per aumentare il numero di istanze
Si applica a: 
Database SQL di Azure
È possibile gestire facilmente i database partizionati con scalabilità orizzontale esistenti usando gli strumenti (come ad esempio la libreria client di database elastici). Come prima cosa convertire un set di database esistente per l'uso del gestore delle mappe partizioni.
Panoramica
Per eseguire la migrazione di un database partizionato esistente:
- Preparare il database del gestore delle mappe partizioni.
- Creare la mappa partizioni.
- Preparare le singole partizioni.
- Aggiungere i mapping alla mappa partizioni.
Queste tecniche possono essere implementate tramite la libreria client .NET Framework o gli script di PowerShell disponibili nella pagina relativa agli script degli strumenti dei database elastici del database SQL di Azure. Negli esempi in questo articolo vengono usati gli script PowerShell.
Per altre informazioni su ShardMapManager, vedere Gestione mappe partizioni. Per informazioni generali sugli strumenti dei database elastici, vedere Panoramica sulle funzionalità di database elastico.
Preparare il database del gestore delle mappe partizioni
Il gestore delle mappe partizioni è un database speciale che contiene i dati per la gestione dei database con un numero maggiore di istanze. È possibile usare un database esistente o crearne un nuovo. Un database che funge da gestore delle mappe partizioni non deve essere lo stesso della partizione. Lo script di PowerShell non crea automaticamente il database.
Passaggio 1: Creare un gestore mappe partizioni
# Create a shard map manager
New-ShardMapManager -UserName '<user_name>' -Password '<password>' -SqlServerName '<server_name>' -SqlDatabaseName '<smm_db_name>'
#<server_name> and <smm_db_name> are the server name and database name
# for the new or existing database that should be used for storing
# tenant-database mapping information.
Per recuperare il gestore mappe partizioni
Dopo la creazione, è possibile recuperare il gestore mappe partizioni con questo cmdlet. Questo passaggio è necessario ogni volta che si deve usare l'oggetto ShardMapManager.
# Try to get a reference to the Shard Map Manager
$ShardMapManager = Get-ShardMapManager -UserName '<user_name>' -Password '<password>' -SqlServerName '<server_name>' -SqlDatabaseName '<smm_db_name>'
Passaggio 2: Creare la mappa partizioni
Selezionare il tipo di mappa partizioni da creare. La scelta dipende dall'architettura del database:
- Singolo tenant per database. Per informazioni sui i termini, vedere il glossario.
- Più tenant per database (due tipi):
- Mapping di tipo elenco
- Mapping di tipo intervallo
Per un modello a singolo tenant, creare una mappa partizioni con mapping di tipo elenco . Il modello single-tenant assegna un database per tenant. Si tratta di un modello efficace per gli sviluppatori SaaS in quanto semplifica la gestione.
Il modello multi-tenant assegna diversi tenant a un database singolo ed è possibile distribuire gruppi di tenant tra più database. Usare questo modello quando si prevedono esigenze di dati ridotte per ogni tenant. In questo modello viene assegnato un intervallo di tenant a un database usando il mapping di tipo intervallo.
In alternativa è possibile implementare un modello di database multi-tenant usando il mapping di tipo elenco per assegnare più tenant a un database singolo. Ad esempio, DB1 viene usato per archiviare le informazioni sugli ID tenant 1 e 5 e DB2 archivia i dati per i tenant 7 e 10.
In base alla scelta effettuata, procedere con una delle opzioni seguenti:
Opzione 1: creare una mappa partizioni per un mapping di tipo elenco
Creare una mappa partizioni usando l'oggetto ShardMapManager.
# $ShardMapManager is the shard map manager object
$ShardMap = New-ListShardMap -KeyType $([int]) -ListShardMapName 'ListShardMap' -ShardMapManager $ShardMapManager
Opzione 2: creare una mappa partizioni per un mapping di tipo intervallo
Per usare questo modello di mapping, i valori dell'ID tenant devono essere a intervalli continui ed è accettabile avere gap negli intervalli ignorando l'intervallo durante la creazione dei database.
# $ShardMapManager is the shard map manager object
# 'RangeShardMap' is the unique identifier for the range shard map.
$ShardMap = New-RangeShardMap -KeyType $([int]) -RangeShardMapName 'RangeShardMap' -ShardMapManager $ShardMapManager
Opzione 3: elencare i mapping su un database singolo
Per l'impostazione di questo modello è necessario anche creare una mappa di tipo elenco, come illustrato nel passaggio 2, opzione 1.
Passaggio 3: preparare le singole partizioni
Aggiungere ciascuna partizione (database) al gestore mappe partizioni. Ciò consente di preparare i singoli database per l'archiviazione delle informazioni di mapping. Eseguire questo metodo su ogni partizione.
Add-Shard -ShardMap $ShardMap -SqlServerName '<shard_server_name>' -SqlDatabaseName '<shard_database_name>'
# The $ShardMap is the shard map created in step 2.
Passaggio 4: aggiungere mapping
L'aggiunta di mapping dipende dal tipo di mappa partizioni creato. Se è stata creata una mappa di tipo elenco, aggiungere mapping di tipo elenco. Se è stata creata una mappa di tipo intervallo, aggiungere mapping di tipo intervallo.
Opzione 1: eseguire il mapping dei dati per il mapping di tipo elenco
Eseguire il mapping dei dati aggiungendo un mapping di tipo elenco per ogni tenant.
# Create the mappings and associate it with the new shards
Add-ListMapping -KeyType $([int]) -ListPoint '<tenant_id>' -ListShardMap $ShardMap -SqlServerName '<shard_server_name>' -SqlDatabaseName '<shard_database_name>'
Opzione 2: eseguire il mapping dei dati per il mapping di tipo intervallo
Aggiungere il mapping di tipo intervallo per tutte le associazioni intervallo ID tenant - database:
# Create the mappings and associate it with the new shards
Add-RangeMapping -KeyType $([int]) -RangeHigh '5' -RangeLow '1' -RangeShardMap $ShardMap -SqlServerName '<shard_server_name>' -SqlDatabaseName '<shard_database_name>'
Passaggio 4, opzione 3: eseguire il mapping dei dati per più tenant su un database singolo
Per ogni tenant eseguire Add-ListMapping (opzione 1).
Verifica dei mapping
È possibile eseguire query per ottenere informazioni sulle partizioni esistenti e sui mapping a esse associati usando i comandi seguenti:
# List the shards and mappings
Get-Shards -ShardMap $ShardMap
Get-Mappings -ShardMap $ShardMap
Riepilogo
Dopo aver completato l'installazione, è possibile iniziare a usare la libreria client di database elastici. È anche possibile usare il routing dipendente dai dati e le query su più partizioni.
Passaggi successivi
Gli script di PowerShell sono disponibili nella pagina relativa agli script degli strumenti dei database elastici di Azure.
La libreria client degli strumenti dei database elastici è disponibile su GitHub: Azure/elastic-db-tools.
Usare lo strumento di suddivisione-unione per spostare dati in o da un modello multi-tenant a un modello single-tenant. Vedere la pagina relativa allo strumento di divisione-unione.
Risorse aggiuntive
Per informazioni sugli schemi di architettura dati comuni delle applicazioni di database multi-tenant software come un servizio (SaaS), vedere Schemi progettuali per applicazioni SaaS multi-tenant con il database SQL di Azure.
Domande e richieste di funzionalità
In caso di domande, usare la pagina Microsoft delle domande e risposte per il database SQL mentre è possibile inserire le richieste di nuove funzionalità nel forum relativo a commenti e suggerimenti sul database SQL.