Stop-AzureSqlDatabaseCopy
Met fin à une relation de copie continue.
Remarque
Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Azure Service Manager (ASM). Ce module PowerShell hérité n’est pas recommandé lors de la création de ressources, car ASM est planifié pour la mise hors service. Pour plus d’informations, consultez la mise hors service d’Azure Service Manager.
Le module Az PowerShell est le module PowerShell recommandé pour la gestion des ressources Azure Resource Manager (ARM) avec PowerShell.
Syntaxe
Stop-AzureSqlDatabaseCopy
-ServerName <String>
-DatabaseCopy <DatabaseCopy>
[-ForcedTermination]
[-Force]
[-Profile <AzureSMProfile>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Stop-AzureSqlDatabaseCopy
-ServerName <String>
-Database <Database>
[-PartnerServer <String>]
[-PartnerDatabase <String>]
[-ForcedTermination]
[-Force]
[-Profile <AzureSMProfile>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Stop-AzureSqlDatabaseCopy
-ServerName <String>
-DatabaseName <String>
[-PartnerServer <String>]
[-PartnerDatabase <String>]
[-ForcedTermination]
[-Force]
[-Profile <AzureSMProfile>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande Stop-AzureSqlDatabaseCopy met fin à une relation de copie continue. Cette applet de commande arrête le déplacement des données entre la base de données source et la base de données secondaire ou cible, puis modifie l’état de la base de données secondaire pour qu’elle soit une base de données en ligne autonome.
Il existe deux façons de mettre fin à une relation de copie continue, d’arrêter ou d’arrêter planifiée et d’arrêter forcée avec une perte de données possible. Sur le serveur qui héberge la base de données source, vous pouvez exécuter cette applet de commande en mode arrêt ou arrêt forcé. Sur le serveur qui héberge la base de données secondaire, vous devez utiliser le mode d’arrêt forcé.
Un arrêt planifié attend que toutes les transactions validées sur la base de données source, au moment où vous exécutez l’applet de commande, aient été répliquées vers la base de données secondaire. L’arrêt forcé n’attend pas la réplication des transactions validées en attente et peut entraîner une perte de données possible dans la base de données secondaire.
Bien que l’état de la réplication soit EN ATTENTE, seule l’arrêt forcé peut mettre fin à une relation de copie continue. Si l’état de réplication est EN ATTENTE, l’arrêt qui n’est pas forcé n’est pas pris en charge.
Exemples
Exemple 1 : Arrêter une relation de copie continue
PS C:\>Stop-AzureSqlDatabaseCopy -ServerName "lpqd0zbr8y" -DatabaseName "Orders" -PartnerServer "bk0b8kf658"
Cette commande met fin à la relation de copie continue de la base de données nommée Orders sur le serveur nommé lpqd0zbr8y. Le serveur nommé bk0b8kf658 héberge la base de données secondaire.
Exemple 2 : Mettre fin de force à une relation de copie continue
PS C:\>$DatabaseCopy = Get-AzureSqlDatabaseCopy -ServerName "lpqd0zbr8y" -DatabaseName "Orders"
PS C:\> $DatabaseCopy | Stop-AzureSqlDatabaseCopy -ServerName "lpqd0zbr8y" -ForcedTermination
La première commande obtient la relation de copie de base de données pour la base de données nommée Orders sur le serveur nommé lpqd0zbr8y.
La deuxième commande met fin à une relation de copie continue à partir du serveur qui héberge la base de données secondaire.
Paramètres
-Confirm
Vous demande une confirmation avant d’exécuter la commande cmdlet.
Type: | SwitchParameter |
Alias: | cf |
Position: | Named |
Valeur par défaut: | False |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Database
Spécifie un objet qui représente la source Azure SQL Database. Cette applet de commande met fin à la relation de copie continue de la base de données spécifiée par ce paramètre.
Type: | Database |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-DatabaseCopy
Spécifie un objet qui représente une base de données. Cette applet de commande met fin à la relation de copie continue de la base de données spécifiée par ce paramètre. Ce paramètre accepte l’entrée de pipeline.
Type: | DatabaseCopy |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-DatabaseName
Spécifie le nom d’une base de données. Cette applet de commande met fin à la relation de copie continue de la base de données spécifiée par ce paramètre.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Force
Force l’exécution de la commande sans demander la confirmation de l’utilisateur.
Type: | SwitchParameter |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-ForcedTermination
Indique que cette applet de commande provoque l’arrêt forcé de la relation de copie continue. L’arrêt forcé peut entraîner une perte de données. Pour exécuter cette applet de commande sur un serveur qui héberge la base de données cible, vous devez spécifier ce paramètre. Pour exécuter cette applet de commande sur un serveur qui héberge la base de données source, si la base de données secondaire n’est pas disponible, vous devez spécifier ce paramètre.
Type: | SwitchParameter |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-PartnerDatabase
Spécifie le nom de la base de données secondaire. Si vous spécifiez un nom, il doit correspondre au nom de la base de données source.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-PartnerServer
Spécifie le nom du serveur qui héberge la base de données cible.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Profile
Spécifie le profil Azure à partir duquel cette applet de commande lit. Si vous ne spécifiez pas de profil, cette applet de commande lit le profil par défaut local.
Type: | AzureSMProfile |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-ServerName
Spécifie le nom du serveur sur lequel réside la base de données source.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-WhatIf
Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.
Type: | SwitchParameter |
Alias: | wi |
Position: | Named |
Valeur par défaut: | False |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
Entrées
Microsoft.WindowsAzure.Commands.SqlDatabase.Model.DatabaseCopy
Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database
Sorties
None
Notes
Authentification : cette applet de commande nécessite une authentification basée sur des certificats. Pour obtenir un exemple d’utilisation de l’authentification basée sur un certificat pour définir l’abonnement actuel, consultez l’applet de commande New-AzureSqlDatabaseServerContext .
Restrictions : sur le serveur qui héberge la base de données secondaire, seul l’arrêt forcé est pris en charge.
Impact de l’arrêt sur l’ancienne base de données secondaire : après l’arrêt, la base de données secondaire devient une base de données indépendante. Si l’amorçage est déjà terminé sur la base de données secondaire, une fois cette base de données terminée, est ouverte pour un accès total. Si la base de données source est une base de données en lecture-écriture, l’ancienne base de données secondaire devient également une base de données en lecture-écriture.
Si l’amorçage est en cours, l’amorçage est abandonné et l’ancienne base de données secondaire ne devient jamais visible sur le serveur qui héberge la base de données secondaire.
Vous pouvez définir la base de données source en mode lecture seule. Cela garantit que les bases de données sources et secondaires sont synchronisées après l’arrêt, et vérifient qu’aucune transaction n’est validée lors de l’arrêt. Une fois l’arrêt terminé, définissez la source sur le mode lecture-écriture. Si vous le souhaitez, vous pouvez également définir l’ancienne base de données secondaire en mode lecture-écriture.
Surveillance : Pour vérifier l’état des opérations à la fois à la source et à la cible de la relation de copie continue, utilisez l’applet de commande Get-AzureSqlDatabaseOperation .