# mysql.rds\$1set\$1external\$1master\$1gtid
<a name="mysql_rds_set_external_master_gtid"></a>

Configura la reproducción basada en GTID desde una instancia de MariaDB que se ejecuta fuera de Amazon RDS a una instancia de base de datos de MariaDB. Este procedimiento almacenado solo se admite cuando la instancia de MariaDB externa tiene la versión 10.0.24 o posterior. Cuando configure una replicación en la que una o las dos instancias no admitan los identificadores de transacciones globales (GTID) de MariaDB, use [mysql.rds\$1set\$1external\$1master (RDS para MariaDB y RDS para las versiones principales de MySQL 8.0 e inferiores)](mysql-stored-proc-replicating.md#mysql_rds_set_external_master).

El uso de GTID para la replicación proporciona características de seguridad en caso de bloqueo que no ofrece la replicación con registros binarios, así que es el procedimiento recomendado cuando las instancias que se van a replicar lo admiten. 

## Sintaxis
<a name="mysql_rds_set_external_master_gtid-syntax"></a>

 

```
CALL mysql.rds_set_external_master_gtid(
  host_name
  , host_port
  , replication_user_name
  , replication_user_password
  , gtid
  , ssl_encryption
);
```

## Parámetros
<a name="mysql_rds_set_external_master_gtid-parameters"></a>

 *host\$1name*   
Cadena. El nombre de host o dirección IP de la instancia de MariaDB ejecutada fuera de Amazon RDS que se convertirá en instancia de origen.

 *host\$1port*   
Entero. El puerto usado por la instancia de MariaDB ejecutada fuera de Amazon RDS que se configurará como instancia de origen. Si la configuración de la red incluye la replicación del puerto SSH que convierte el número de puerto, especifique el número de puerto expuesto por SSH.

 *replication\$1user\$1name*   
Cadena. ID de un usuario con permisos `REPLICATION SLAVE` en la instancia de base de datos de MariaDB que se va a configurar como réplica de lectura.

 *replication\$1user\$1password*   
Cadena. La contraseña del ID de usuario especificado en `replication_user_name`.

 *gtid*   
Cadena. El ID de transacción global de la instancia de origen desde el que debe comenzar la replicación.  
Puede usar `@@gtid_current_pos` para obtener el GTID actual si la instancia de origen se ha bloqueado mientras se configura la replicación con el fin de que el registro binario no cambie entre los puntos en los que se obtiene el GTID y comienza la replicación.  
De lo contrario, si usa `mysqldump` versión 10.0.13 o posterior para rellenar la instancia de réplica antes de comenzar la replicación, puede obtener la posición de GTID en la salida usando las opciones `--master-data` o `--dump-slave`. Si no usa `mysqldump` 10.0.13 o posterior, puede ejecutar `SHOW MASTER STATUS` o usar las mismas opciones de `mysqldump` para obtener el nombre y la posición del archivo de registro binario y convertirlos a continuación en un GTID ejecutando `BINLOG_GTID_POS` en la instancia de MariaDB externa:  

```
SELECT BINLOG_GTID_POS('<binary log file name>', <binary log file position>);
```
Para obtener más información acerca de la implementación de los GTID en MariaDB, vaya a [Global Transaction ID](http://mariadb.com/kb/en/mariadb/global-transaction-id/) en la documentación de MariaDB.

 *ssl\$1encryption*   
Valor que especifica si el cifrado de la capa de conexión segura (SSL) se usa en la conexión de reproducción. El 1 especifica que se usa el cifrado SSL; el 0 especifica que no se usa el cifrado. El valor predeterminado es 0.  
La opción `MASTER_SSL_VERIFY_SERVER_CERT` no es compatible. Esta opción se establece en 0, lo que significa que la conexión está cifrada, pero los certificados no se verifican.

## Notas de uso
<a name="mysql_rds_set_external_master_gtid-usage-notes"></a>

El usuario maestro debe ejecutar el procedimiento `mysql.rds_set_external_master_gtid`. Se debe ejecutar en la instancia de base de datos de MariaDB que se está configurando como réplica de una instancia de MariaDB que se ejecuta fuera de Amazon RDS. Antes de ejecutar `mysql.rds_set_external_master_gtid`, debe haber configurado la instancia de MariaDB que se ejecuta fuera de Amazon RDS como instancia de origen. Para obtener más información, consulte [Importación de datos en una instancia de base de datos de Amazon RDS para MariaDB](MariaDB.Procedural.Importing.md).

**aviso**  
No use `mysql.rds_set_external_master_gtid` para administrar la replicación entre dos instancias de base de datos de Amazon RDS. Úselo solo cuando replique con una instancia de MariaDB que se ejecute fuera de RDS. Para obtener información sobre la administración de la replicación entre instancias de base de datos de Amazon RDS, consulte [Trabajo con réplicas de lectura de instancias de base de datos](USER_ReadRepl.md).

Después de llamar a `mysql.rds_set_external_master_gtid` para configurar una instancia de base de datos de Amazon RDS como réplica de lectura, puede llamar a [mysql.rds\$1start\$1replication](mysql-stored-proc-replicating.md#mysql_rds_start_replication) en la réplica para iniciar el proceso de replicación. Puede llamar a [mysql.rds\$1reset\$1external\$1master (RDS para MariaDB y RDS para las versiones principales de MySQL 8.0 e inferiores)](mysql-stored-proc-replicating.md#mysql_rds_reset_external_master) para eliminar la configuración de la réplica de lectura.

Cuando se llama a `mysql.rds_set_external_master_gtid`, Amazon RDS registra la hora, el usuario y una acción "set master" en las tablas `mysql.rds_history` y `mysql.rds_replication_status`.

## Ejemplos
<a name="mysql_rds_set_external_master_gtid-examples"></a>

Cuando se ejecuta en una instancia de base de datos de MariaDB, el siguiente ejemplo la configura como réplica de una instancia de MariaDB que se ejecuta fuera de Amazon RDS.

```
call mysql.rds_set_external_master_gtid ('Sourcedb.some.com',3306,'ReplicationUser','SomePassW0rd','0-123-456',0); 
```