REST Resource: projects.locations.services.migrationExecutions

資源:MigrationExecution

遷移執行作業資源的詳細資料。

JSON 表示法
{
  "name": string,
  "createTime": string,
  "endTime": string,
  "state": enum (State),
  "phase": enum (Phase),
  "stateMessage": string,

  // Union field migration_config can be only one of the following:
  "cloudSqlMigrationConfig": {
    object (CloudSQLMigrationConfig)
  }
  // End of list of possible types for union field migration_config.
}
欄位
name

string

僅供輸出。遷移執行作業的相對資源名稱,格式如下:projects/{projectNumber}/locations/{locationId}/services/{serviceId}/migrationExecutions/{migration_execution_id}

createTime

string (Timestamp format)

僅供輸出。開始執行遷移作業的時間。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,精確度達奈秒單位,最多九個小數位數。例如:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

endTime

string (Timestamp format)

僅供輸出。遷移執行作業完成的時間。

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,精確度達奈秒單位,最多九個小數位數。例如:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

state

enum (State)

僅供輸出。遷移作業目前的執行狀態。

phase

enum (Phase)

僅供輸出。遷移作業目前的執行階段。

stateMessage

string

僅供輸出。遷移執行作業目前狀態的其他資訊。

聯集欄位 migration_config。Dataproc Metastore 啟動遷移程序 migration_config 所需的設定資訊只能是下列其中一種:
cloudSqlMigrationConfig

object (CloudSQLMigrationConfig)

針對從 Google Cloud 中的自行管理 Hive 中繼存放區 (使用 Cloud SQL 做為後端資料庫) 遷移至 Dataproc Metastore 的特定設定資訊。

CloudSQLMigrationConfig

設定資訊:從 Google Cloud 中自行管理的 Hive 中繼存放區 (使用 Cloud SQL 做為後端資料庫) 遷移至 Dataproc Metastore。

JSON 表示法
{
  "cdcConfig": {
    object (CdcConfig)
  },
  "cloudSqlConnectionConfig": {
    object (CloudSQLConnectionConfig)
  }
}
欄位
cdcConfig

object (CdcConfig)

這是必要旗標,此設定資訊是用於啟動從客戶資料庫到 Dataproc Metastore 後端資料庫的變更資料擷取 (CDC) 串流。在遷移作業的轉換階段結束後,Dataproc Metastore 會改用自己的後端資料庫。

cloudSqlConnectionConfig

object (CloudSQLConnectionConfig)

這是必要旗標,在遷移的轉換階段前,用於建立客戶資料庫連線的設定資訊

CdcConfig

此設定資訊是用於啟動從客戶資料庫到 Dataproc Metastore 後端資料庫的變更資料擷取 (CDC) 串流。

JSON 表示法
{
  "vpcNetwork": string,
  "subnetIpRange": string,
  "username": string,
  "password": string,
  "reverseProxySubnet": string,
  "bucket": string,
  "rootPath": string
}
欄位
vpcNetwork

string

這是必要旗標,Cloud SQL 執行個體虛擬私有雲網路或 Datastream 要對接的共用虛擬私有雲網路的完整名稱,格式如下:projects/{projectId}/locations/global/networks/{network_id}。詳情請參閱 https://cloud.google.com/datastream/docs/network-connectivity-options#privateconnectivity

subnetIpRange

string

這是必要旗標,與 Datastream 對接的 /29 CIDR IP 範圍。

username

string

這是必要旗標,Datastream 服務連線至 MySQL 時應使用的使用者名稱。

password

string

這是必要旗標,僅限輸入。Datastream 服務應使用 MySQL 連線的使用者密碼。系統不會在要求中傳回這個欄位。

reverseProxySubnet

string

這是必要旗標,子網路資源網址,該資源可用來建立託管反向 Proxy 的 VM 執行個體。如需更多背景資訊,請參閱 https://cloud.google.com/datastream/docs/private-connectivity#reverse-csql-proxy。子網路應位於 Datastream 要進行對接的要求所提供的網路,且應與 Datastream 位於相同區域,格式如下。projects/{projectId}/regions/{region_id}/subnetworks/{subnetwork_id}

bucket

string

(非必要) 用來寫入中繼串流事件資料的 bucket。bucket 名稱不得包含前置字串,例如「gs://」。請參閱值區命名規定。這是選填欄位。如未設定,系統會使用 Artifacts Cloud Storage bucket。

rootPath

string

(非必要) Cloud Storage 值區中的根路徑。串流事件資料會寫入這個路徑。預設值為 /migration

CloudSQLConnectionConfig

在遷移的轉換階段前,用於建立客戶資料庫連線的設定資訊

JSON 表示法
{
  "instanceConnectionName": string,
  "ipAddress": string,
  "port": integer,
  "hiveDatabaseName": string,
  "username": string,
  "password": string,
  "proxySubnet": string,
  "natSubnet": string
}
欄位
instanceConnectionName

string

這是必要旗標,Cloud SQL 資料庫連線名稱 (projectId:region:instance_name)

ipAddress

string

這是必要旗標,Cloud SQL 執行個體的私人 IP 位址。

port

integer

這是必要旗標,資料庫的網路通訊埠。

hiveDatabaseName

string

這是必要旗標,Hive 資料庫名稱。

username

string

這是必要旗標,Dataproc Metastore 服務連線至資料庫要用的使用者名稱。

password

string

這是必要旗標,僅限輸入。Dataproc Metastore 服務連線至資料庫要用的使用者密碼。系統不會在要求中傳回這個欄位。

proxySubnet

string

這是必要旗標,要在其中部署 SOCKS5 Proxy 服務的子網路相對資源名稱。子網路應位於可存取 Cloud SQL 執行個體的網路。資源名稱的格式應為 projects/{projectId}/regions/{region_id}/subnetworks/{subnetwork_id}

natSubnet

string

這是必要旗標,要用於 Private Service Connect 的子網路相對資源名稱。請注意,這無法做為一般子網路,僅適用於 NAT。https://cloud.google.com/vpc/docs/about-vpc-hosted-services#psc-subnets這個子網路是用於發布 SOCKS5 Proxy 服務。子網路大小至少須為 /29,且應位於可存取 Cloud SQL 執行個體的網路中。資源名稱的格式應為 projects/{projectId}/regions/{region_id}/subnetworks/{subnetwork_id}

狀態

遷移作業目前的執行狀態。

列舉
STATE_UNSPECIFIED 遷移作業執行狀態不明。
STARTING 正在開始執行遷移作業。
RUNNING 正在執行遷移作業。
CANCELLING 正在取消執行遷移作業。
AWAITING_USER_ACTION 遷移作業正在等待使用者採取行動。
SUCCEEDED 遷移作業已順利完成。
FAILED 遷移作業執行失敗。
CANCELLED 取消執行遷移作業。
DELETING 正在刪除遷移作業。

階段

遷移作業目前的執行階段。

列舉
PHASE_UNSPECIFIED 遷移作業執行階段不明。
REPLICATION 複製階段是指 Dataproc Metastore 執行管道,將客戶資料庫中的變更複製到後端資料庫的遷移階段。在此階段,Dataproc Metastore 會使用客戶資料庫做為 Hive 中繼存放區後端資料庫。
CUTOVER 轉換階段是指 Dataproc Metastore 改用自己的後端資料庫的遷移階段。當客戶完成將所有叢集/工作負載遷移至 Dataproc Metastore 並觸發 CompleteMigration 時,遷移作業就會進入這個階段。

方法

delete

刪除單一遷移執行作業。

get

取得單一遷移執行作業的詳細資料。

list

列出服務上的遷移執行作業。