# ネイティブ Db2 ツールを使用して Db2 から Amazon RDS for Db2 にデータを移行する
複数のネイティブ Db2 ツール、ユーティリティ、およびコマンドを使用して、Db2 データベースから Amazon RDS for Db2 データベースにデータを直接移動できます。これらのネイティブ Db2 ツールを使用するには、クライアントマシンを RDS for Db2 DB インスタンスに接続できる必要があります。詳細については、「[クライアントマシンを Amazon RDS for Db2 DB インスタンスに接続する](db2-connecting-client-rds.md)」を参照してください。
**注記**
データを移動するもう 1 つの方法は、まず Amazon S3 バケットに保存してから、`LOAD` コマンドを使用して、そのデータを RDS for Db2 データベースのテーブルに転送することです。この方法は、RDS for Db2 と S3 間のネットワーク接続が良好であるため、大量のデータを移行する場合に最適なパフォーマンスを提供します。詳細については、「[Amazon S3 から Amazon RDS for Db2 への Db2 データの移行](db2-migration-load-from-s3.md)」を参照してください。
| ツール名 | ユースケース | 制限 |
| --- | --- | --- |
| [db2look](db2-native-db2-tools-db2look.md) | セルフマネージド Db2 データベースから RDS for Db2 データベースにメタデータをコピーする。 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/db2-native-db2-tools.html) |
| [IMPORT コマンド](db2-native-db2-tools-import.md) | 小さなテーブルとラージオブジェクト (LOB) を含むテーブルをクライアントマシンから RDS for Db2 DB インスタンスに移行する。 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/db2-native-db2-tools.html) |
| [INGEST ユーティリティ](db2-native-db2-tools-ingest.md) | クライアントマシンでラージオブジェクト (LOB) がない**ファイルやパイプから RDS for Db2 DB インスタンスにデータを継続的にストリーミングする。`INSERT` および `MERGE` オペレーションをサポートする。 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/db2-native-db2-tools.html) |
| [INSERT コマンド](db2-native-db2-tools-insert.md) | セルフマネージド Db2 データベースから RDS for Db2 データベースに小さなテーブルのデータをコピーする。 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/db2-native-db2-tools.html) |
| [LOAD CLIENT コマンド](db2-native-db2-tools-load.md) | ラージオブジェクト (LOB) のない**小さなテーブルをクライアントマシンから RDS for Db2 DB インスタンスに移行する。 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/db2-native-db2-tools.html) |
# クライアントマシンを Amazon RDS for Db2 DB インスタンスに接続する
ネイティブ Db2 ツールのいずれかを使用して Db2 データベースから Amazon RDS for Db2 データベースにデータを移動するには、まずクライアントマシンを RDS for Db2 DB インスタンスに接続する必要があります。
以下のいずれかのクライアントマシンを使用できます。
+ Linux、Windows、または macOS 上の Amazon Elastic Compute Cloud (Amazon EC2) インスタンス このインスタンスは、RDS for Db2 DB インスタンス、AWS Cloud9 または AWS CloudShell と同じ仮想プライベートクラウド (VPC) にある必要があります。
+ Amazon EC2 インスタンスのセルフマネージド Db2 インスタンス。インスタンスは同じ VPC 内にある必要があります。
+ Amazon EC2 インスタンスのセルフマネージド Db2 インスタンス。VPC ピアリングが有効になっている場合は、インスタンスが別の VPC にあってもかまいません。詳細については、「*Amazon Virtual Private Cloud ピアリング接続ガイド*」の「[Create a VPC peering connection](https://docs.aws.amazon.com/vpc/latest/peering/create-vpc-peering-connection.html)」を参照してください。
+ セルフマネージド環境で Linux、Windows、または macOS を実行しているローカルマシン。RDS for Db2 へのパブリック接続があるか、セルフマネージド Db2 インスタンスと AWS 間の VPN 接続を有効にする必要があります。
クライアントマシンを RDS for Db2 DB インスタンスに接続するには、IBM Db2 Data Management Console を使用してクライアントマシンにログインします。詳細については、「[Amazon RDS DB インスタンスの作成](USER_CreateDBInstance.md)」および「[IBM Db2 Data Management Console](db2-connecting-with-ibm-data-management-console.md)」を参照してください。
AWS Database Migration Service (AWS DMS) を使用して、データベースに対してクエリを実行し、SQL 実行プランを実行し、データベースをモニタリングできます。詳細については、「AWS Database Migration Service ユーザーガイド**」の「[What is AWS Database Migration Service?](https://docs.aws.amazon.com/dms/latest/userguide/Welcome.html)」を参照してください。
クライアントマシンを RDS for Db2 DB インスタンスに正常に接続したら、ネイティブ Db2 ツールを使用してデータをコピーできます。詳細については、「[ネイティブ Db2 ツールを使用して Db2 から Amazon RDS for Db2 にデータを移行する](db2-native-db2-tools.md)」を参照してください。
# db2look を使用して Db2 から Amazon RDS for Db2 にデータベースメタデータをコピーする
`db2look` は、データ定義言語 (DDL) ファイル、オブジェクト、認証、設定、WLM、およびデータベースレイアウトを抽出するネイティブ Db2 ツールです。`db2look` を使用して、セルフマネージド Db2 データベースから Amazon RDS for Db2 データベースにデータベースメタデータをコピーできます。詳細については、IBM Db2 ドキュメントの「[Mimicking databases using db2look](https://www.ibm.com/docs/en/db2/11.5?topic=tools-db2look)」を参照してください。
**データベースメタデータをコピーするには**
1. セルフマネージド Db2 システムで `db2look` ツールを実行し、DDL ファイルを抽出します。次の例では、*database\$1name* を Db2 データベースの名前に置き換えます。
```
db2look -d database_name -e -l -a -f -wlm -cor -createdb -printdbcfg -o db2look.sql
```
1. クライアントマシンがソース (セルフマネージド Db2) データベースと RDS for Db2 DB インスタンスにアクセスできる場合は、リモートインスタンスに直接アタッチすることで、クライアントマシンで `db2look.sql` ファイルを作成できます。次に、リモートのセルフマネージド Db2 インスタンスをカタログ化します。
1. ノードをカタログ化します。次の例では、*dns\$1ip\$1address* と *port* を、DNS 名または IP アドレス、セルフマネージド Db2 データベースのポート番号に置き換えます。
```
db2 catalog tcpip node srcnode REMOTE dns_ip_address server port
```
1. データベースをカタログ化します。次の例では、*source\$1database\$1name* と *source\$1database\$1alias* を、セルフマネージド Db2 データベースの名前と、このデータベースに使用するエイリアスに置き換えます。
```
db2 catalog database source_database_name as source_database_alias at node srcnode \
authentication server_encrypt
```
1. ソースデータベースにアタッチします。次の例では、*source\$1database\$1alias*、*user\$1id*、*user\$1password* を、前のステップで作成したエイリアスと、セルフマネージド Db2 データベースのユーザー ID とパスワードに置き換えます。
```
db2look -d source_database_alias -i user_id -w user_password -e -l -a -f -wlm \
-cor -createdb -printdbcfg -o db2look.sql
```
1. クライアントマシンからリモートのセルフマネージド Db2 データベースにアクセスできない場合は、`db2look.sql` ファイルをクライアントマシンにコピーします。 次に、RDS for Db2 DB インスタンスをカタログ化します。
1. ノードをカタログ化します。次の例では、*dns\$1ip\$1address* と *port* を、DNS 名または IP アドレスと、RDS for Db2 DB インスタンスのポート番号に置き換えます。
```
db2 catalog tcpip node remnode REMOTE dns_ip_address server port
```
1. データベースをカタログ化します。次の例では、*rds\$1database\$1name* と *rds\$1database\$1alias* を、RDS for Db2 データベースの名前と、このデータベースに使用するエイリアスに置き換えます。
```
db2 catalog database rds_database_name as rds_database_alias at node remnode \
authentication server_encrypt
```
1. RDS for Db2 を管理する管理データベースをカタログ化します。このデータベースを使用してデータを保存することはできません。
```
db2 catalog database rdsadmin as rdsadmin at node remnode authentication server_encrypt
```
1. バッファプールとテーブルスペースを作成します。管理者には、バッファプールまたはテーブルスペースを作成する権限がありません。ただし、Amazon RDS ストアドプロシージャを使用して作成することができます。
1. `db2look.sql` ファイル内のバッファプールとテーブルスペースの名前と定義を見つけます。
1. RDS for Db2 DB インスタンスのマスターユーザー名とマスターパスワードを使用して Amazon RDS に接続します。次の例では、*master\$1username* と *master\$1password* をユーザー自身の情報に置き換えます。
```
db2 connect to rdsadmin user master_username using master_password
```
1. `rdsadmin.create_bufferpool` を呼び出してバッファプールを作成します。詳細については、「[rdsadmin.create\$1bufferpool](db2-sp-managing-buffer-pools.md#db2-sp-create-buffer-pool)」を参照してください。
```
db2 "call rdsadmin.create_bufferpool(
'database_name',
'buffer_pool_name',
buffer_pool_size,
'immediate',
'automatic',
page_size,
number_block_pages,
block_size)"
```
1. `rdsadmin.create_tablespace` を呼び出してテーブルスペースを作成します。詳細については、「[rdsadmin.create\$1tablespace](db2-sp-managing-tablespaces.md#db2-sp-create-tablespace)」を参照してください。
```
db2 "call rdsadmin.create_tablespace(
'database_name',
'tablespace_name',
'buffer_pool_name',
tablespace_initial_size,
tablespace_increase_size,
'tablespace_type')"
```
1. 追加するバッファプールまたはテーブルスペースごとに、ステップ c または d を繰り返します。
1. 接続を終了します。
```
db2 terminate
```
1. テーブルとオブジェクトを作成します。
1. RDS for Db2 DB インスタンスのマスターユーザー名とマスターパスワードを使用して、RDS for Db2 データベースに接続します。次の例では、*rds\$1database\$1name*、*master\$1username*、*master\$1password* をユーザー自身の情報に置き換えます。
```
db2 connect to rds_database_name user master_username using master_password
```
1. `db2look.sql` ファイルを実行します。
```
db2 -tvf db2look.sql
```
1. 接続を終了します。
```
db2 terminate
```
# IMPORT コマンドを使用してクライアントマシンから Amazon RDS for Db2 にデータをインポートする
クライアントマシンで `IMPORT` コマンドを使用して、Amazon RDS for Db2 サーバーにデータをインポートできます。
**重要**
`IMPORT` コマンドメソッドは、小さなテーブルやラージオブジェクト (LOB) を含むテーブルを移行する場合に便利です。`IMPORT` コマンドは、`INSERT` および `DELETE` のログ記録オペレーションのため、`LOAD` ユーティリティよりも低速です。クライアントマシンと RDS for Db2 間のネットワーク帯域幅が制限されている場合は、別の移行アプローチを使用することをお勧めします。詳細については、「[ネイティブ Db2 ツールを使用して Db2 から Amazon RDS for Db2 にデータを移行する](db2-native-db2-tools.md)」を参照してください。
**RDS for Db2 サーバーにデータをインポートするには**
1. IBM Db2 Data Management Console を使用してクライアントマシンにログインします。詳細については、「[IBM Db2 Data Management Console を使用して Amazon RDS for Db2 DB インスタンスに接続する](db2-connecting-with-ibm-data-management-console.md)」を参照してください。
1. クライアントマシン上の RDS for Db2 データベースをカタログ化します。
1. ノードをカタログ化します。次の例では、*dns\$1ip\$1address* と *port* を、DNS 名または IP アドレス、セルフマネージド Db2 データベースのポート番号に置き換えます。
```
db2 catalog tcpip node srcnode REMOTE dns_ip_address server port
```
1. データベースをカタログ化します。次の例では、*source\$1database\$1name* と *source\$1database\$1alias* を、セルフマネージド Db2 データベースの名前と、このデータベースに使用するエイリアスに置き換えます。
```
db2 catalog database source_database_name as source_database_alias at node srcnode \
authentication server_encrypt
```
1. ソースデータベースにアタッチします。次の例では、*source\$1database\$1alias*、*user\$1id*、*user\$1password* を、前のステップで作成したエイリアスと、セルフマネージド Db2 データベースのユーザー ID とパスワードに置き換えます。
```
db2look -d source_database_alias -i user_id -w user_password -e -l -a -f -wlm \
-cor -createdb -printdbcfg -o db2look.sql
```
1. セルフマネージド Db2 システムで ` EXPORT` コマンドを使用してデータファイルを生成します。次の例では、*directory* を、データファイルが存在するクライアントマシン上のディレクトリに置き換えます。*file\$1name* と *table\$1name* をデータファイルの名前とテーブルの名前に置き換えます。
```
db2 "export to /directory/file_name.txt of del lobs to /directory/lobs/ \
modified by coldel\| select * from table_name"
```
1. RDS for Db2 DB インスタンスのマスターユーザー名とマスターパスワードを使用して、RDS for Db2 データベースに接続します。次の例では、**rds\$1database\$1alias**、*master\$1username*、*master\$1password* をユーザー自身の情報に置き換えます。
```
db2 connect to rds_database_alias user master_username using master_password
```
1. `IMPORT` コマンドを使用して、クライアントマシン上のファイルからリモート RDS for Db2 データベースにデータをインポートします。詳細については、IBM Db2 ドキュメントの「[IMPORT command](https://www.ibm.com/docs/en/db2/11.5?topic=commands-import)」を参照してください。次の例では、*directory* と *file\$1name* を、データファイルが存在するクライアントマシン上のディレクトリとデータファイルの名前に置き換えます。*SCHEMA\$1NAME* と *TABLE\$1NAME* をスキーマとテーブルの名前に置き換えます。
```
db2 "IMPORT from /directory/file_name.tbl OF DEL LOBS FROM /directory/lobs/ \
modified by coldel\| replace into SCHEMA_NAME.TABLE_NAME"
```
1. 接続を終了します。
```
db2 terminate
```
# LOAD コマンドを使用してクライアントマシンから Amazon RDS for Db2 にデータをインポートする
`LOAD CLIENT` コマンドを使用して、クライアントマシン上のファイルから RDS for Db2 サーバーにデータをロードできます。RDS for Db2 サーバーへの SSH 接続は存在しないため、セルフマネージド Db2 サーバーまたは Db2 クライアントマシンのいずれかで `LOAD CLIENT` コマンドを使用できます。
**重要**
`LOAD CLIENT` コマンドメソッドは、小さなテーブルの移行に便利です。クライアントと RDS for Db2 間のネットワーク帯域幅が制限されている場合は、別の移行アプローチを使用することをお勧めします。詳細については、「[ネイティブ Db2 ツールを使用して Db2 から Amazon RDS for Db2 にデータを移行する](db2-native-db2-tools.md)」を参照してください。
データファイルにラージオブジェクトファイル名への参照が含まれている場合、ラージオブジェクト (LOB) は Db2 サーバー上に存在する必要があるため、`LOAD` コマンドは機能しません。クライアントマシンから RDS for Db2 サーバーに LOB をロードしようとすると、SQL3025N エラーが発生します。代わりに [IMPORT コマンド](db2-native-db2-tools-import.md)を使用します。
**RDS for Db2 サーバーにデータをロードするには**
1. IBM Db2 Data Management Console を使用してクライアントマシンにログインします。詳細については、「[IBM Db2 Data Management Console を使用して Amazon RDS for Db2 DB インスタンスに接続する](db2-connecting-with-ibm-data-management-console.md)」を参照してください。
1. クライアントマシン上の RDS for Db2 データベースをカタログ化します。
1. ノードをカタログ化します。次の例では、*dns\$1ip\$1address* と *port* を、DNS 名または IP アドレス、セルフマネージド Db2 データベースのポート番号に置き換えます。
```
db2 catalog tcpip node srcnode REMOTE dns_ip_address server port
```
1. データベースをカタログ化します。次の例では、*source\$1database\$1name* と *source\$1database\$1alias* を、セルフマネージド Db2 データベースの名前と、このデータベースに使用するエイリアスに置き換えます。
```
db2 catalog database source_database_name as source_database_alias at node srcnode \
authentication server_encrypt
```
1. ソースデータベースにアタッチします。次の例では、*source\$1database\$1alias*、*user\$1id*、*user\$1password* を、前のステップで作成したエイリアスと、セルフマネージド Db2 データベースのユーザー ID とパスワードに置き換えます。
```
db2look -d source_database_alias -i user_id -w user_password -e -l -a -f -wlm \
-cor -createdb -printdbcfg -o db2look.sql
```
1. セルフマネージド Db2 システムで `EXPORT` コマンドを使用して、データファイルを生成します。次の例では、*directory* を、データファイルが存在するクライアントマシン上のディレクトリに置き換えます。*file\$1name* と *TABLE\$1NAME* をデータファイルの名前とテーブルの名前に置き換えます。
```
db2 "export to /directory/file_name.txt of del modified by coldel\| \
select * from TPCH.TABLE_NAME"
```
1. RDS for Db2 DB インスタンスのマスターユーザー名とマスターパスワードを使用して、RDS for Db2 データベースに接続します。次の例では、**rds\$1database\$1alias*、**master\$1username*、*master\$1password* をユーザー自身の情報に置き換えます。
```
db2 connect to rds_database_alias user master_username using master_password
```
1. `LOAD` コマンドを使用して、クライアントマシン上のファイルからリモート RDS for Db2 データベースにデータをロードします。詳細については、IBM Db2 ドキュメントの「[LOAD command](https://www.ibm.com/docs/en/db2/11.5?topic=commands-load)」を参照してください。次の例では、*directory* を、データファイルが存在するクライアントマシン上のディレクトリに置き換えます。*file\$1name* と *TABLE\$1NAME* をデータファイルの名前とテーブルの名前に置き換えます。
```
db2 "LOAD CLIENT from /directory/file_name.txt \
modified by coldel\| replace into TPCH.TABLE_NAME \
nonrecoverable without prompting"
```
1. 接続を終了します。
```
db2 terminate
```
# INSERT コマンドを使用して Db2 から Amazon RDS for Db2 にデータをインポートする
`INSERT` コマンドを使用して、セルフマネージド Db2 サーバーから Amazon RDS for Db2 データベースにデータを挿入できます。この移行アプローチでは、リモート RDS for Db2 DB インスタンスのニックネームを使用します。セルフマネージド Db2 データベース (ソース) は、RDS for Db2 データベース (ターゲット) に接続できる必要があります。
**重要**
`INSERT` コマンドメソッドは、小さなテーブルの移行に便利です。セルフマネージド Db2 データベースと RDS for Db2 データベース間のネットワーク帯域幅が制限されている場合は、別の移行アプローチを使用することをお勧めします。詳細については、「[ネイティブ Db2 ツールを使用して Db2 から Amazon RDS for Db2 にデータを移行する](db2-native-db2-tools.md)」を参照してください。
**セルフマネージド Db2 データベースから RDS for Db2 データベースにデータをコピーするには**
1. セルフマネージド Db2 インスタンスで RDS for Db2 DB インスタンスをカタログ化します。
1. ノードをカタログ化します。次の例では、*dns\$1ip\$1address* と *port* を、DNS 名または IP アドレス、セルフマネージド Db2 データベースのポート番号に置き換えます。
```
db2 catalog tcpip node remnode REMOTE dns_ip_address SERVER port
```
1. データベースをカタログ化します。次の例では、*rds\$1database\$1name* を RDS for Db2 DB インスタンスのデータベースの名前に置き換えます。
```
db2 catalog database rds_database_name as remdb at node remnode \
authentication server_encrypt
```
1. セルフマネージド Db2 インスタンスでフェデレーションを有効にします。次の例では、*source\$1database\$1name* をセルフマネージド Db2 インスタンスのデータベースの名前に置き換えます。
```
db2 update dbm cfg using FEDERATED YES source_database_name
```
1. RDS for Db2 DB インスタンスでテーブルを作成します。
1. ノードをカタログ化します。次の例では、*dns\$1ip\$1address* と *port* を、DNS 名または IP アドレス、セルフマネージド Db2 データベースのポート番号に置き換えます。
```
db2 catalog tcpip node srcnode REMOTE dns_ip_address server port
```
1. データベースをカタログ化します。次の例では、*source\$1database\$1name* と *source\$1database\$1alias* を、セルフマネージド Db2 データベースの名前と、このデータベースに使用するエイリアスに置き換えます。
```
db2 catalog database source_database_name as source_database_alias at node srcnode \
authentication server_encrypt
```
1. ソースデータベースにアタッチします。次の例では、*source\$1database\$1alias*、*user\$1id*、*user\$1password* を、前のステップで作成したエイリアスと、セルフマネージド Db2 データベースのユーザー ID とパスワードに置き換えます。
```
db2look -d source_database_alias -i user_id -w user_password -e -l -a -f -wlm \
-cor -createdb -printdbcfg -o db2look.sql
```
1. フェデレーションを設定し、セルフマネージド Db2 インスタンスの RDS for Db2 データベーステーブルのニックネームを作成します。
1. ローカルデータベースに接続します。次の例では、*source\$1database\$1name* をセルフマネージド Db2 インスタンスのデータベースの名前に置き換えます。
```
db2 connect to source_database_name
```
1. Db2 データソースにアクセスするためのラッパーを作成します。
```
db2 create wrapper drda
```
1. フェデレーションデータベースでデータソースを定義します。次の例では、*admin* と *admin\$1password* をセルフマネージド Db2 インスタンスの認証情報に置き換えます。*rds\$1database\$1name* を RDS for Db2 DB インスタンスのデータベースの名前に置き換えます。
```
db2 "create server rdsdb2 type DB2/LUW version '11.5.9.0' \
wrapper drda authorization "admin" password "admin_password" \
options( dbname 'rds_database_name', node 'remnode')"
```
1. 2 つのデータベースのユーザーをマッピングします。次の例では、*master\$1username* と *master\$1password* を RDS for Db2 DB インスタンスの認証情報に置き換えます。
```
db2 "create user mapping for user server rdsdb2 \
options (REMOTE_AUTHID 'master_username', REMOTE_PASSWORD 'master_password')"
```
1. RDS for Db2 サーバーへの接続を確認します。
```
db2 set passthru rdsdb2
```
1. リモート RDS for Db2 データベースのテーブルのニックネームを作成します。次の例では、*NICKNAME* と *TABLE\$1NAME* をテーブルのニックネームとテーブルの名前に置き換えます。
```
db2 create nickname REMOTE.NICKNAME for RDSDB2.TABLE_NAME.NICKNAME
```
1. リモート RDS for Db2 データベースのテーブルにデータを挿入します。セルフマネージド Db2 インスタンスのローカルテーブルの `select` ステートメントでニックネームを使用します。次の例では、*NICKNAME* と *TABLE\$1NAME* をテーブルのニックネームとテーブルの名前に置き換えます。
```
db2 "INSERT into REMOTE.NICKNAME select * from RDS2DB2.TABLE_NAME.NICKNAME"
```
# INGEST ユーティリティを使用した Db2 から Amazon RDS for Db2 へのデータのインポート
`INGEST` ユーティリティを使用して、クライアントマシン上のファイルとパイプからターゲットの Amazon RDS for Db2 DB インスタンスにデータを継続的にストリーミングできます。`INGEST` ユーティリティは、`INSERT` および `MERGE` オペレーションをサポートします。詳細については、IBM Db2 ドキュメントの「[Ingest utility](https://www.ibm.com/docs/en/db2/11.1?topic=reference-ingest-utility)」を参照してください。
`INGEST` ユーティリティはニックネームをサポートしているため、このユーティリティを使用して、セルフマネージド Db2 データベースから RDS for Db2 データベースにデータを転送できます。このアプローチは、2 つのデータベース間にネットワーク接続が存在する限り機能します。
**重要**
`INGEST` ユーティリティはラージオブジェクト (LOB) はサポートしていません。代わりに [`IMPORT` コマンド](db2-native-db2-tools-import.md)を使用します。
`INGEST` ユーティリティの `RESTARTABLE` 機能を使用するには、RDS for Db2 データベースで次のコマンドを実行します。
```
db2 "call sysproc.sysinstallobjects(‘INGEST’,‘C’,NULL,NULL)"
```