Compartir a través de


az sql db replica

Administrar la replicación entre bases de datos.

Comandos

Nombre Description Tipo Estado
az sql db replica create

Cree una base de datos como una réplica secundaria legible de una base de datos existente.

Core GA
az sql db replica delete-link

Detenga permanentemente la replicación de datos entre dos réplicas de base de datos.

Core GA
az sql db replica list-links

Indique las réplicas de una base de datos y su estado de replicación.

Core GA
az sql db replica set-primary

Establezca la base de datos de réplica principal mediante la conmutación por error de la base de datos de réplica principal actual.

Core GA

az sql db replica create

Cree una base de datos como una réplica secundaria legible de una base de datos existente.

Para ver una lista completa de las opciones de nivel de rendimiento, ejecute az sql db list-editions -a -o table -l LOCATION. La base de datos secundaria debe tener la misma edición que la base de datos principal.

az sql db replica create --name
                         --partner-server
                         --resource-group
                         --server
                         [--assign-identity {false, true}]
                         [--auto-pause-delay]
                         [--availability-zone]
                         [--backup-storage-redundancy --bsr]
                         [--capacity]
                         [--compute-model {Provisioned, Serverless}]
                         [--elastic-pool]
                         [--encryption-protector]
                         [--encryption-protector-auto-rotation --epauto {false, true}]
                         [--family]
                         [--federated-client-id]
                         [--ha-replicas --read-replicas]
                         [--keys]
                         [--license-type {BasePrice, LicenseIncluded}]
                         [--min-capacity]
                         [--no-wait]
                         [--partner-database]
                         [--partner-resource-group]
                         [--partner-sub-id]
                         [--preferred-enclave-type {Default, VBS}]
                         [--read-scale {Disabled, Enabled}]
                         [--secondary-type]
                         [--service-level-objective --service-objective]
                         [--tags]
                         [--umi --user-assigned-identity-id]
                         [--zone-redundant {false, true}]

Ejemplos

Cree una base de datos con el nivel de rendimiento S0 como réplica secundaria de una base de datos Estándar existente.

az sql db replica create -g mygroup -s myserver -n originalDb --partner-server newDb --service-objective S0

Creación de una base de datos con la edición GeneralPurpose, hardware Gen4 y 1 núcleo virtual como réplica secundaria de una base de datos GeneralPurpose existente

az sql db replica create -g mygroup -s myserver -n originalDb --partner-server newDb -f Gen4 -c 1

Cree una base de datos con almacenamiento de copia de seguridad con redundancia de zona como una réplica secundaria de una base de datos existente.

az sql db replica create -g mygroup -s myserver -n originalDb --partner-server newDb --backup-storage-redundancy Zone

Parámetros requeridos

--name -n

Nombre de Azure SQL Database.

--partner-server

Nombre del servidor en el que se va a crear la nueva réplica.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--server -s

Nombre de Azure SQL Server. Puede configurar el valor predeterminado mediante az configure --defaults sql-server=<name>.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--assign-identity -i

Asignar identidad para la base de datos.

Propiedad Valor
Valores aceptados: false, true
--auto-pause-delay

Hora en minutos después de la cual la base de datos se pausa automáticamente. Un valor de -1 significa que la pausa automática está deshabilitada.

Propiedad Valor
Grupo de parámetros: Serverless offering Arguments
--availability-zone

Zona de disponibilidad.

--backup-storage-redundancy --bsr

Redundancia de almacenamiento de copia de seguridad usada para almacenar copias de seguridad. Entre los valores permitidos se incluyen: Local, Zone, Geo, GeoZone.

--capacity -c

Componente de capacidad de la SKU en número entero de DTU o vcores.

Propiedad Valor
Grupo de parámetros: Performance Level (components) Arguments
--compute-model

Modelo de proceso de la base de datos.

Propiedad Valor
Grupo de parámetros: Serverless offering Arguments
Valores aceptados: Provisioned, Serverless
--elastic-pool

Nombre o identificador de recurso del grupo elástico en el que se va a crear la base de datos.

Propiedad Valor
Grupo de parámetros: Performance Level Arguments
--encryption-protector

Especifica la clave del almacén de claves de Azure que se va a usar como clave de protector de cifrado de base de datos.

--encryption-protector-auto-rotation --epauto

Especifica la marca de rotación automática de clave protector de cifrado de base de datos. Puede ser true, false o null.

Propiedad Valor
Valores aceptados: false, true
--family -f

Componente de generación de proceso de la SKU (solo para SKU de núcleo virtual). Entre los valores permitidos se incluyen: Gen4, Gen5.

Propiedad Valor
Grupo de parámetros: Performance Level (components) Arguments
--federated-client-id

Identificador de cliente federado para SQL Database. Se usa para el escenario de CMK entre inquilinos.

--ha-replicas --read-replicas

Número de réplicas de alta disponibilidad que se van a aprovisionar para la base de datos. Solo se puede establecer para la edición hiperescala.

--keys

Lista de claves de AKV para SQL Database.

--license-type

Tipo de licencia que se va a solicitar para esta base de datos. LicenseIncluded si necesita una licencia o BasePricesi tiene una licencia y es apta para Azure HybridBenefit.

Propiedad Valor
Valores aceptados: BasePrice, LicenseIncluded
--min-capacity

Capacidad mínima que la base de datos siempre tendrá asignada, si no está en pausa.

Propiedad Valor
Grupo de parámetros: Serverless offering Arguments
--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad Valor
Valor predeterminado: False
--partner-database

Nombre de la nueva réplica. Si no se especifica, el valor predeterminado es el nombre de la base de datos de origen.

--partner-resource-group

Nombre del grupo de recursos en el que se va a crear la nueva réplica. Si no se especifica, el valor predeterminado es el grupo de recursos de origen.

--partner-sub-id

Identificador de suscripción en el que se va a crear la nueva réplica. Si no se especifica, el valor predeterminado es el identificador de suscripción de origen.

--preferred-enclave-type

Especifica el tipo de enclave para este recurso.

Propiedad Valor
Valores aceptados: Default, VBS
--read-scale

Si está habilitada, las conexiones que tienen intención de aplicación establecida en readonly en su cadena de conexión se pueden enrutar a una réplica secundaria de solo lectura. Esta propiedad solo se puede establecer para las bases de datos Premium y Crítico para la empresa.

Propiedad Valor
Valores aceptados: Disabled, Enabled
--secondary-type

Tipo de secundario que se va a crear. Entre los valores permitidos se incluyen: Geo, Named.

--service-level-objective --service-objective

Objetivo de servicio para la nueva base de datos. Por ejemplo: Básico, S0, P1, GP_Gen4_1, GP_S_Gen5_8, BC_Gen5_2, HS_Gen5_32.

Propiedad Valor
Grupo de parámetros: Performance Level Arguments
--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--umi --user-assigned-identity-id

Lista de identidades asignadas por el usuario para SQL Database.

--zone-redundant -z

Especifica si se va a habilitar la redundancia de zona. El valor predeterminado es true si no se especifica ningún valor.

Propiedad Valor
Valores aceptados: false, true
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

Detenga permanentemente la replicación de datos entre dos réplicas de base de datos.

az sql db replica delete-link --partner-server
                              [--ids]
                              [--name]
                              [--partner-resource-group]
                              [--resource-group]
                              [--server]
                              [--subscription]
                              [--yes]
--partner-server

Nombre del servidor en el que se encuentra la otra réplica.

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--name -n

Nombre de Azure SQL Database.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--partner-resource-group

Nombre del grupo de recursos en el que se encuentra la otra réplica. Si no se especifica, el valor predeterminado es el primer grupo de recursos de la base de datos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--server -s

Nombre de Azure SQL Server. Puede configurar el valor predeterminado mediante az configure --defaults sql-server=<name>.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--yes -y

No solicita confirmación.

Propiedad Valor
Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

Indique las réplicas de una base de datos y su estado de replicación.

az sql db replica list-links [--ids]
                             [--name]
                             [--resource-group]
                             [--server]
                             [--subscription]

Indique las réplicas de una base de datos y su estado de replicación. (autogenerated)

az sql db replica list-links --name MyAzureSQLDatabase --resource-group MyResourceGroup --server myserver

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--name -n

Nombre de Azure SQL Database.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--server -s

Nombre de Azure SQL Server. Puede configurar el valor predeterminado mediante az configure --defaults sql-server=<name>.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az sql db replica set-primary

Establezca la base de datos de réplica principal mediante la conmutación por error de la base de datos de réplica principal actual.

az sql db replica set-primary [--allow-data-loss]
                              [--ids]
                              [--name]
                              [--resource-group]
                              [--server]
                              [--subscription]

Ejemplos

Establezca la base de datos de réplica principal mediante la conmutación por error de la base de datos de réplica principal actual. (autogenerated)

az sql db replica set-primary --allow-data-loss --name MyDatabase --resource-group MyResourceGroup --server myserver --subscription MySubscription

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--allow-data-loss

Si se especifica, la operación de conmutación por error permitirá la pérdida de datos.

Propiedad Valor
Valor predeterminado: False
--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--name -n

Nombre de la base de datos que se va a conmutar por error.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--resource-group -g

Nombre del grupo de recursos que contiene la réplica secundaria que se convertirá en la nueva principal.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--server -s

Nombre del servidor que contiene la réplica secundaria que se convertirá en la nueva principal. Puede configurar el valor predeterminado mediante az configure --defaults sql-server=<name>.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False