使用 mysqldump 匯出 MySQL 資料庫

您可以使用自己需要的任何選項,直接對 MySQL 資料庫執行 mysqldump 公用程式。不過,如果您要匯出資料並匯入至 Cloud SQL 資料庫,請使用 mysqldump 公用程式搭配下列標記:

  • --databases 指定要匯出的資料庫明確清單。此清單「不得」包含系統資料庫 (sysmysqlperformance_schemainformation_schema)。
  • --hex-blob 如果資料庫包含任何二進位檔欄位,您必須使用此標記來確保正確匯入二進位檔欄位。
  • --single-transaction 在執行前啟動交易。這麼做可讓 mysqldump 讀取目前狀態的資料庫,而非鎖定整個資料庫,進而產生一致的資料傾印。
  • --routines 如果要加入預存程序和函式,
  • 使用 mysqldump 8 以上版本匯出 8 以下版本的 MySQL 資料庫時
    --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 執行個體,以便保留 binlog 更久的時間。這個指令可能如下列範例:

    # 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 中建立的值區,用於儲存傾印檔案 (例如 replica-bucket)。
[DUMP_FILENAME] 備份檔案的檔案名稱,結尾為 .gz 副檔名 (例如 source-database.sql.gz)。