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 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

endTime

string (Timestamp format)

出力専用。移行実行が完了した時刻。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

state

enum (State)

出力専用。移行実行の現在の状態。

phase

enum (Phase)

出力専用。移行実行の現在のフェーズ。

stateMessage

string

出力専用。移行実行の現在の状態に関する追加情報。

共用体フィールド migration_config。移行プロセス migration_config の開始に Dataproc Metastore で必要な構成情報は、次のいずれかになります。
cloudSqlMigrationConfig

object (CloudSQLMigrationConfig)

バックエンド データベースとして Cloud SQL を使用する Google Cloud のセルフマネージド Hive メタストアから Dataproc Metastore に移行する場合に固有の構成情報。

CloudSQLMigrationConfig

バックエンド データベースとして Cloud SQL を使用する Google Cloud のセルフマネージド Hive メタストアから 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

必須。Datastream がピアリングする Cloud SQL インスタンスの VPC ネットワークまたは共有 VPC ネットワークの完全修飾名(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

必須。リバース プロキシをホストする VM インスタンスを作成するサブネットワーク リソースの URL。詳細については、https://cloud.google.com/datastream/docs/private-connectivity#reverse-csql-proxy をご覧ください。サブネットワークは、リクエストで指定された、Datastream がピアリングするネットワークに存在し、Datastream と同じリージョンに存在する必要があります。形式は次のとおりです。projects/{projectId}/regions/{region_id}/subnetworks/{subnetwork_id}

bucket

string

省略可。中間ストリーム イベントデータを書き込むバケット。バケット名には、「gs://」などの接頭辞を含めないでください。バケットの命名要件をご覧ください。このフィールドは省略可能です。設定されていない場合は、アーティファクトの Cloud Storage バケットが使用されます。

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 プロキシ サービスをデプロイするサブネットワークの相対リソース名。サブネットワークは、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 プロキシ サービスの公開に使用されます。サブネット サイズは /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 Metastore バックエンド データベースとしてお客様のデータベースを使用します。
CUTOVER カットオーバー フェーズとは、Dataproc Metastore が独自のバックエンド データベースを使用するように切り替わる移行フェーズを指します。すべてのクラスタまたはワークロードを Dataproc Metastore に移行し、CompleteMigration をトリガーすると、移行はこのフェーズに入ります。

メソッド

delete

1 つの移行実行を削除します。

get

1 回の移行実行の詳細を取得します。

list

サービスでの移行実行を一覧表示します。