接続プロファイルは、ソース データベースの識別子と接続認証情報をキャプチャします。各接続プロファイルには、Database Migration Service がデータソースと宛先間のデータ移動を容易にするために必要な最小限の情報が含まれています。
ソース接続プロファイルを作成する手順は次のとおりです。
コンソール
- Google Cloud コンソールの [ 接続プロファイル] ページに移動します。
- [プロファイルを作成] をクリックします。
- [接続プロファイルの作成] ページの [プロファイル ロール] リストから、[ソース] を選択します。
- [データベース エンジン] リストから、移行元データベース エンジンを選択します。
- [接続プロファイル名] フィールドに、接続プロファイルの人が読める名前を入力します。この値は、接続プロファイル リストに表示されます。
- 自動生成された接続プロファイル ID を保持します。
- ホスト名または IP アドレスを入力します。
-
ここで使用する値は、移行に使用する接続方法によって異なります。たとえば、ソース データベースが Google Cloudでホストされている場合や、リバース SSH トンネルを使用して宛先クラスタをソース データベースに接続する場合は、ソース データベースのプライベート(内部)IP アドレスを指定します。詳細については、 ネットワーク接続の概要をご覧ください。
- IP 許可リストを使用して公共のインターネット経由で接続する移行の場合は、移行元データベースのパブリック IP アドレスを指定します。
-
- ホストへのアクセスに使用するポートを入力します。デフォルトの PostgreSQL ポートは 5432 です。
- ソース データベースのユーザー名とパスワードを入力します。ユーザーには、ソース データベースで必要なレプリケーション権限が必要です。詳細については、 ソース データベースを構成するをご覧ください。
- ページの [接続プロファイルのリージョン] セクションで、接続プロファイルを保存するリージョンを選択します。
省略可: パブリック ネットワーク上で(IP 許可リストを使用して)接続している場合は、ソース データベースと宛先データベース間の接続に SSL / TLS 暗号化を構成することをおすすめします。
[接続を保護する] セクションで、次のいずれかの SSL / TLS 構成オプションを選択します。
- なし: AlloyDB for PostgreSQL の宛先クラスタは、暗号化なしでソース データベースに接続します。
- TLS 認証: AlloyDB for PostgreSQL の宛先クラスタがソース データベースに接続すると、クラスタはソースを認証し、クラスタが正しいホストに安全に接続していることを確認します。TLS 認証を使用するには、ソースサーバーの証明書に署名した CA の x509 PEM エンコード証明書を指定する必要があります。
- mTLS 認証: 宛先クラスタがソースに接続すると、クラスタはソースを認証し、ソースはクラスタを認証します。mTLS 認証を使用するには、以下を指定する必要があります。
- ソース データベース サーバーの証明書に署名した CA の証明書(CA 証明書)。
- クラスタがソース データベース サーバーに対する認証に使用する証明書(クライアント証明書)。
- クライアント証明書に関連付けられた秘密鍵(クライアント鍵)。
[作成] をクリックします。
[接続プロファイル] ページが表示され、新しく作成された接続プロファイルが表示されます。
gcloud
このサンプルでは、オプションの --no-async フラグを使用して、すべてのオペレーションが同期的に実行されるようにしています。そのため、一部のコマンドは完了するまでに時間がかかることがあります。--no-async フラグをスキップして、コマンドを非同期で実行できます。その場合は、gcloud database-migration operations describe コマンドを使用して、オペレーションが成功したかどうかを確認する必要があります。
後述のコマンドデータを使用する前に、次のように置き換えます。
- SOURCE_CONN_ID は、ソース接続プロファイル ID に置き換えます。
- REGION は、接続プロファイルを保存するリージョンに置き換えます。
- SOURCE_IP_ADDRESS は、ソース データベースの IP アドレスに置き換えます。
- SOURCE_PORT は、ソース データベースのポートに置き換えます(デフォルトは 5432)。
- SOURCE_USER は、ソース データベースの移行ユーザーのユーザー名に置き換えます。
- SOURCE_PASSWORD は、移行元データベースの移行ユーザーのパスワードに置き換えます。
- 省略可: 追加のソース接続プロファイル設定を構成するには、次のフラグを渡します。
--display-name: 接続プロファイルの人が読める形式の名前。--cloudsql-instance: ソースが Cloud SQL for PostgreSQL の場合、ソース Cloud SQL for PostgreSQL インスタンスの ID。--ssl-type: ソース データベースへの接続の SSL / TLS 暗号化タイプ(NONE、--ca-certificateを使用した TLS 認証の場合はSERVER_ONLY、--ca-certificate、--client-certificate、--private-keyを使用した mTLS 認証の場合はSERVER_CLIENT)。
次のコマンドを実行します。
Linux、macOS、Cloud Shell
gcloud database-migration connection-profiles create postgresql \ SOURCE_CONN_ID \ --region=REGION \ --role=SOURCE \ --host=SOURCE_IP_ADDRESS \ --port=SOURCE_PORT \ --username=SOURCE_USER \ --password=SOURCE_PASSWORD \ --no-async
Windows(PowerShell)
gcloud database-migration connection-profiles create postgresql ` SOURCE_CONN_ID ` --region=REGION ` --role=SOURCE ` --host=SOURCE_IP_ADDRESS ` --port=SOURCE_PORT ` --username=SOURCE_USER ` --password=SOURCE_PASSWORD ` --no-async
Windows(cmd.exe)
gcloud database-migration connection-profiles create postgresql ^ SOURCE_CONN_ID ^ --region=REGION ^ --role=SOURCE ^ --host=SOURCE_IP_ADDRESS ^ --port=SOURCE_PORT ^ --username=SOURCE_USER ^ --password=SOURCE_PASSWORD ^ --no-async
次のようなレスポンスが返されます。
Waiting for connection profile [SOURCE_CONN_ID] to be created with [OPERATION_ID] Waiting for operation [OPERATION_ID] to complete...done. Created connection profile SOURCE_CONN_ID [OPERATION_ID]