mysql.rds_set_external_master_gtid

Configura la replica basata su GTID da un'istanza MariaDB in esecuzione all'esterno di Amazon RDS a un'istanza database MariaDB. Questa procedura archiviata è supportata solo se l'istanza esterna di MariaDB è la versione 10.0.24 o successiva. Quando configuri una replica dove una o entrambe le istanze non supportano gli ID globale di transazione (GTID) di MariaDB, utilizza mysql.rds_set_external_master.

L'utilizzo di GTID per la replica offre funzioni di sicurezza contro l'arresto anomalo non offerte dalla replica dei log binari. Pertanto è consigliata per la replica di istanze che li supportano.

Sintassi

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

Parametri

host_name

Stringa. Il nome host o l'indirizzo IP dell'istanza MariaDB in esecuzione all'esterno di Amazon RDS che diventerà l’istanza di origine.

host_port

Numero intero. La porta utilizzata dall'istanza MariaDB in esecuzione all'esterno di Amazon RDS da configurare come istanza di origine. Se la configurazione della rete include la replica della porta SSH che converte il numero di porta, specifica il numero di porta esposto da SSH.

replication_user_name

Stringa. L'ID di un utente con autorizzazioni REPLICATION SLAVE nell'istanza database MariaDB da configurare come replica di lettura.

replication_user_password

Stringa. La password dell'ID utente specificata in replication_user_name.

gtid

Stringa. L'ID globale di transazione sull’istanza di origine dalla quale la replica dovrebbe iniziare.

Puoi utilizzare @@gtid_current_pos per ottenere il GTID corrente se l’istanza di origine è stata bloccata durante la configurazione della replica, così il log binario non cambia tra i punti quando ottieni il GTID e quando la replica inizia.

In alternativa, se utilizzi mysqldump versione 10.0.13 o successiva per compilare l'istanza di replica prima di avviare la replica, puoi ottenere la posizione GTID nell'output utilizzando l'opzione --master-data o --dump-slave. Se non utilizzi mysqldump versione 10.0.13 o successiva, puoi eseguire SHOW MASTER STATUS o utilizzare quelle stesse opzioni mysqldump per ottenere il nome e la posizione del file di log binario, quindi convertirle in un GTID eseguendo BINLOG_GTID_POS sull'istanza MariaDB esterna:

SELECT BINLOG_GTID_POS('<binary log file name>', <binary log file position>);

Per ulteriori informazioni sull'implementazione di GTID di MariaDB, consulta ID globale di transazione (GTID) nella documentazione di MariaDB.

ssl_encryption

Un valore che specifica se la crittografia Secure Socket Layer (SSL) è utilizzata sulla connessione di replica. 1 indica che la crittografia SSL deve essere utilizzata; 0 specifica che la crittografia non deve essere utilizzata. Il valore predefinito è 0.

Nota

L'opzione MASTER_SSL_VERIFY_SERVER_CERT non è supportata. Questa opzione è impostata su 0, il che significa che la connessione è crittografata, ma i certificati non sono verificati.

Note per l'utilizzo

La procedura mysql.rds_set_external_master_gtid deve essere eseguita dall'utente master. Deve essere eseguita sull'istanza database MariaDB che stai configurando come replica di un'istanza MariaDB in esecuzione all'esterno di Amazon RDS. Prima di eseguire mysql.rds_set_external_master_gtid, devi aver configurato l'istanza di MariaDB in esecuzione all'esterno di Amazon RDS come istanza di origine. Per ulteriori informazioni, consulta Importazione di dati in un'istanza database MariaDB.

avvertimento

Non usare mysql.rds_set_external_master_gtid per gestire la replica tra due istanze database Amazon RDS. Utilizzala soltanto nel caso della replica con un'istanza di MariaDB in esecuzione all'esterno di RDS. Per ulteriori informazioni sulla gestione della replica tra istanze database Amazon RDS, consulta Uso delle repliche di lettura dell'istanza database.

Dopo aver chiamato mysql.rds_set_external_master_gtid per configurare un'istanza database di Amazon RDS come una replica di lettura, puoi chiamare mysql.rds_start_replication nella replica per avviare il processo di replica. Puoi chiamare mysql.rds_reset_external_master per rimuovere la configurazione della replica di lettura.

Quando mysql.rds_set_external_master_gtid viene chiamato, Amazon RDS registra l'ora, l'utente e un'operazione di "impostazione master" nelle tabelle mysql.rds_history e mysql.rds_replication_status.

Examples (Esempi)

Nel caso di esecuzione di un'istanza database MariaDB, l'esempio seguente la configura come replica di un'istanza di MariaDB in esecuzione all'esterno di Amazon RDS.

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