使用 mysqldump 匯出 MySQL 資料庫

您可以使用自己需要的任何選項，直接對相關 MySQL 資料庫執行 mysqldump 公用程式。不過，如果匯出資料是要匯入 Cloud SQL 資料庫，請使用 mysqldump 公用程式，並加上下列標記：

  • --databases 明確指定要匯出的資料庫清單。這份清單不得包含系統資料庫 (sys、mysql、performance_schema 和 information_schema)。
  • --hex-blob 如果資料庫包含任何二進位檔欄位，您必須使用此標記來確保正確匯入二進位檔欄位。
  • --single-transaction 在執行前啟動交易。這樣一來，mysqldump 就能讀取資料庫的目前狀態，產生一致的資料傾印檔，而不必鎖定整個資料庫。
  • --routines 如要納入預存程序和函式，

  • 使用 mysqldump 8 以上版本匯出 MySQL 資料庫 (版本早於 8) 時：
    --column-statistics=0

    這個旗標會從資料庫匯出作業中移除 COLUMN_STATISTICS 資料表，避免發生 Unknown table 'COLUMN_STATISTICS' in information_schema (1109) 錯誤。詳情請參閱「診斷問題」。

此外，建議使用下列旗標：

  • --no-autocommit
  • --default-character-set=utf8mb4
  • --master-data

在可連線至 MySQL 伺服器的機器上，執行下列指令：

    mysqldump \
        -h [SOURCE_ADDR] -P [SOURCE_PORT] -u [USERNAME] -p \
        --databases [DBS]  \
        --hex-blob \
        --no-autocommit \
        --default-character-set=utf8mb4 \
        --master-data=1  \
        --single-transaction \
        --routines \
        | gzip \
        | gcloud storage cp - gs://[BUCKET_NAME]/[DUMP_FILENAME].gz

如果遷移來源是 MySQL 適用的關聯式資料庫服務 (RDS)：

  • 系統不支援 master-data 屬性。
  • 如果來源資料庫伺服器支援 GTID，請使用 --set-gtid-purged=on 屬性；否則請勿使用這個屬性。
  • 如果您使用手動傾印遷移資料，請啟用 GTID 執行遷移作業。

這個指令可能如下列範例：

    mysqldump \
        -h [SOURCE_ADDR] -P [SOURCE_PORT] -u [USERNAME] -p \
        --databases [DBS]  \
        --hex-blob  \
        --no-autocommit \
        --default-character-set=utf8mb4 \
        --set-gtid-purged=on \
        --single-transaction \
        --routines \ 
        | gzip \
        | gcloud storage cp - gs://[BUCKET_NAME]/[DUMP_FILENAME].gz

此外，您應設定 RDS 執行個體，延長保留二進位記錄的時間。這個指令可能如下列範例：

    # Sets the retention period to one week.
    call mysql.rds_set_configuration('binlog retention hours', 168);

將 [PROPERTIES_IN_BRACKETS] 替換成下列值：

屬性 值
[SOURCE_ADDR] 來源資料庫伺服器的 IPv4 位址或主機名稱。
[SOURCE_PORT] 來源資料庫伺服器的通訊埠。
[USERNAME] MySQL 使用者帳戶。
[DBS] 以空格分隔的來源資料庫伺服器資料庫清單，使用 SHOW DATABASES MySQL 指令列出資料庫。
[BUCKET_NAME] 使用者在 Cloud Storage 中建立，並用於儲存 dump 檔案的值區 (例如 replica-bucket)。
[DUMP_FILENAME] 傾印的檔案名稱，結尾為 .gz 副檔名 (例如 source-database.sql.gz)。