はじめに
本記事では、Oracle Database@AzureのOracle Autonomous Database (ADB)へ、Oracle Data Pumpを使用してデータ移行を行う方法を紹介します。
今回利用するADBの環境は、以下の記事と同様の手順で作成しています。
今回構成するアーキテクチャ
以下の図のように、Blob Storageにダンプファイルをアップロードし、Blob storageからOracle Database@Azure上のADBへダンプファイルを直接インポートしていきます。
事前準備
①エクスポート済のダンプファイルの準備
事前準備として、まずは手元のPCにエクスポート済のダンプ・ファイルを用意します。
今回は、こちらのリンクの「はじめに」の章にある、以下の4つのダンプファイルを自身のPCにダウンロードしておきます。
②踏み台サーバーからDatabase Actionsに接続できるようにする
以下の記事の環境が準備できている必要があります。
踏み台サーバーを構築して、RDP接続によりDatabase Actionsに接続できるようにしておきましょう。
③踏み台サーバーからクライアントツールでADBに接続できるようにする
BaseDBやExaDB-XSなどと比較して、ADBはOSに直接SSH接続できないので、ADBにアクセスするための準備をしていきます。
③-1. Oracle Instant Client をダウンロードする
まずは、踏み台サーバーにRDP接続をします。
踏み台サーバーから、Oracle Instant Client ダウンロードページにアクセスして、最新バージョンのBasic Light Packageをダウンロードしていきます。
今回の例ですと、Version 23.7.0.25.01 > Base - one of these packages is required > Basic Light PackageのZipファイル (instantclient-basiclite-windows.x64-23.7.0.25.01)をダウンロードします。
その後、Zipファイルを任意のフォルダに展開しておきます。
今回は、以下のように展開しています。
「C:\Users\ADB\Downloads\instantclient-basiclite-windows.x64-23.7.0.25.01
また今回はData Pumpを利用するので、追加でTools Packageもダウンロードしておきます。
今回の例ですと、Version 23.7.0.25.01 > Tools - optional packages > Tools PackageのZipファイル (instantclient-tools-windows.x64-23.7.0.25.01)をダウンロードします。
こちらのZipファイルも展開して、Toolsのinstantclientに入っているファイルをBasic Lightのinstantclientのフォルダの中にコピーします。
言語設定に関して
Windowsサーバーはデフォルトで英語になっているので、日本語が良い方は「Setting > Time & Language > Language & region」から、「Add a language」で日本語を追加して設定して、再起動すると日本語表示になります。
本記事でもここからは日本語設定で解説していきます。
③-2. ADBからをWalletをダウンロードする
踏み台サーバー上で、OCIコンソールのADBの画面を開き、「データベース接続」をクリックし、「インスタンスウォレット」を選択して、「ウォレットのダウンロード」を選択します。
任意のパスワードを入力して、ダウンロードします。
その後、Zipファイルを任意のフォルダに展開しておきます。
今回は、以下のように展開しています。
C:\Users\ADB\Downloads\Wallet_OracleADB
③-3. Walletフォルダ内部のsqlnet.ora 設定手順
Walletをダウンロードした直後は、「sqlnet.ora」に含まれるパスが相対参照 (?/network/admin)になっており、Instant Client環境では無効のパスです。
なので、まずはコマンドプロンプトでcdコマンドを使い、sqlnet.oraがあるフォルダまで移動し、以下のコマンドを実行して、sqlnet.oraの中身をメモ帳を使って書き換えていきます。
notepad C:\Users\ADB\Downloads\Wallet_OracleADB\sqlnet.ora
sqlnet.oraの初期状態では、以下のように記載されています。この状態では、ADBに接続することはできません。
WALLET_LOCATION = (SOURCE = (METHOD = file) (METHOD_DATA = (DIRECTORY="?/network/admin")))
SSL_SERVER_DN_MATCH = no
なので、以下のようにsqlnet.oraの中身を書き換えてください。
DIRECTORYには、Walletファイルが格納されているフォルダの絶対パスを指定してください。
今回、私の場合だと「C:/Users/ADB/Downloads/Wallet_OracleADB」のパスになっています。
WALLET_LOCATION = (SOURCE = (METHOD = file) (METHOD_DATA = (DIRECTORY = C:/Users/ADB/Downloads/Wallet_OracleADB)))
SSL_SERVER_DN_MATCH = yes
③-4. Windowsで環境変数の設定をする
踏み台サーバー上で、スタートボタン横の検索窓に、「システムの詳細」と入力して、「システムの詳細設定の表示」を選択します。
「環境変数」を選択します。
「ユーザー環境変数」欄の中にある「Path」を選択し、「編集」をクリックします。
「新規」をクリックして、次のようにインストールしたInstant Clientのフォルダパスを追加します。
※フォルダの中の「instantclient_23_7」までを含めたパスになっていることに注意。
C:\Users\ADB\Downloads\instantclient-basiclite-windows.x64-23.7.0.25.01\instantclient_23_7
「OK」をクリックして、環境変数のPathの変更は完了です。
続いて、TNS_ADMINの設定として、同じく環境変数でWalletフォルダを指定していきます。
「ユーザー環境変数」欄で「*新規」をクリックします。
変数名と変数値 (Walletのパス)を以下のように入力していきます。
入力したら「OK」をクリックします。残った「環境変数」と「システムのプロパティ」のウィンドウも「OK」をクリックして閉じていきます。
TNS_ADMIN
C:\Users\ADB\Downloads\Wallet_OracleADB
実際に環境変数が有効になっているか、コマンドプロンプトを開いて以下のように入力します。
echo %PATH%
echo %TNS_ADMIN%
C:\Users\ADB>echo %PATH%
C:\Windows\system32;C:\Windows;C:\Windows\System32\Wbem;C:\Windows\System32\WindowsPowerShell\v1.0\;C:\Windows\System32\OpenSSH\;C:\Program Files\dotnet\;C:\Users\ADB\AppData\Local\Microsoft\WindowsApps;C:\Users\ADB\Downloads\instantclient-basiclite-windows.x64-23.7.0.25.01\instantclient_23_7;
C:\Users\ADB>echo %TNS_ADMIN%
C:\Users\ADB\Downloads\Wallet_OracleADB
%PATH% は Windowsの動作に必要なシステムフォルダも含まれるため、たくさん表示されても問題ありません。
④Visual C++ Redistributable のインストール
デフォルトのWindowsサーバーでは、impdpの実行に必要なVisual C++ ランタイムがシステムに存在しないため、インストールしておく必要があります。
以下のページにアクセスして、「Visual Studio 2015, 2017, 2019, and 2022」のセクションから、x64のインストーラーをダウンロードします。
インストーラを実行して完了です。
Blob Storageの構築
ストレージ アカウントとBlob Storage Containersを構築していきます。
ストレージアカウントの作成
まずは、Azureで画面上部の検索窓に「storage」と入力して、「ストレージ アカウント」を選択します。
「作成」をクリックします。
「基本情報」に必要な情報を入力していきます。
入力し終わったら、「次へ」をクリックします。
プロジェクトの詳細
- サブスクリプション：ADBと同じものを選択。
- リソースグループ：ADBと同じものを選択。
インスタンスの詳細
- ストレージアカウント名：任意の名前を入力。
- リージョン：ADBと同じリージョンを選択。
- プライマリサービス：今回は、Blob Storageを構築するので、「Azure Blob StorageまたはAzure Data Lake Storage Gen 2」を選択。
- パフォーマンス：「Standard」を選択。
-
冗長性：「ローカル冗長ストレージ(LRA)」を選択。
「詳細」に関しては、今回はデフォルトのままで問題ありませんので、「次へ」をクリックします。
「ネットワーク」も、今回はデフォルトのままで問題ありませんので、「次へ」をクリックします。
「データ保護」も、今回はデフォルトのままで問題ありませんので、「次へ」をクリックします。
「暗号化」も、今回はデフォルトのままで問題ありませんので、「次へ」をクリックします。
「タグ」に関しては、必要ならば追加してください。「次へ」をクリックします。
構成の概要が表示されますので、問題がなければ、「作成」をクリックします。
作成が終わるまで数分待機します。
デプロイが完了したら、「リソースに移動」をクリックします。
コンテナーの作成
画面左側の「データストレージ」⇒「コンテナー」を選択して、「＋コンテナー」をクリックします。
任意のコンテナー名を入力し、「作成」をクリックします。
ダンプファイルのアップロード
コンテナーが作成されたら、そのコンテナーの名前をクリックします。
「アップロード」をクリックすると、画面右側にBLOBのアップロード画面が出てくるので、冒頭にダウンロードした4つのダンプファイルを選択します。最後に、青いボタンの「アップロード」をクリックすることで、ダンプファイルをBlob Storage上に配置することができました。
アップロードされたことを確認したら、右側の「…」をクリックして、「プロパティ」をクリックします。
4つダンプファイルで、記載のURLをコピーして記録していきます。
4つとも以下のような形式のURLになっていると思います。
https://adb.blob.core.windows.net/adb-container/export_hr_01.dmp
ADB@AzureへのData Pumpによる移行
下準備が終わったので、ADBへData Pumpでインポートしていきます。
1⃣資格情報を作成する
ADBからBlob Storageにアクセスするには、まず資格情報を作成する必要があります。
そのためには、Blob Storage上のダンプファイルにアクセスするためのアカウント名とパスワードが必要です。
先ほど作成したストレージアカウントに移動して、画面左側の「セキュリティとネットワーク」⇒「アクセスキー」選択します。
「ストレージアカウント名」と「キー」をコピーします。キーがパスワードになるので、「表示」をクリックするとキーをコピーできます。
次に、踏み台サーバーからADBのDatabase Actionsを開き、ADMINで「DBMS_CLOUD.CREATE_CREDENTIAL」を実行していきます。
Database Actionsへのアクセス方法は以下をご覧ください。
Database Actionsにアクセスできたら、画面左上のメニューを開き、「SQL」をクリックします。
まずは、画面左側のタブが「ADMIN」になっていることを確認します。
その後、以下のPL/SQL文を入力した後、「スクリプトを実行」をクリックし、正常に出力されたら資格情報の作成は完了です。
- credential：任意の名前を入力します。今回は「BLOBCRED」と入力しています。
- username：ストレージアカウントのアクセスキーで調べた「ストレージアカウント名」を入力。
- password：ストレージアカウントのアクセスキーで調べた「キー」を入力。
BEGIN
DBMS_CLOUD.CREATE_CREDENTIAL(
credential_name => 'BLOBCRED',
username => '<アカウント名>',
password => '<パスワード/キー>'
);
END;
/
2⃣実際にBlob Storageにアクセスできるか確認する。
Blob Storageへのアクセステストを行っていきます。
DBMS_CLOUD.LIST_OBJECTS資格情報とURLを指定して実行することで、コンテナ内のファイルを一覧表示します。
URLに関しては、ダンプファイルをアップロードした際に、ダンプファイルのURLをコピーしたと思うので、そのURLの末尾のファイル名を削除してください。
✖ https://samig1.blob.core.windows.net/contmig1/HR.DMP ⇚ ファイル名がいらない。
〇 https://samig1.blob.core.windows.net/contmig1/
先ほどと同様に、Database Actionsで以下のSQL文を入力した後、「文の実行」をクリックし、アップロードしたダンプファイルが出力されたらアクセステストは完了です。
SELECT * FROM DBMS_CLOUD.LIST_OBJECTS('BLOBCRED','<コンテナのURL>');
3⃣インポートをするためのパラメータファイルを作成
踏み台サーバーで、インポート用のパラメータファイルを作成していきます。
コマンドプロンプトを起動して、CDコマンドで、Instant Clientと同じフォルダに移動し、以下内容を自身の内容に書き換えて入力します。
今回のフォルダは、「C:\Users\ADB\Downloads\instantclient-basiclite-windows.x64-23.7.0.25.01\instantclient_23_7」です。
- CREDENTIALS：先ほど作成した認証情報の名前を指定。今回は「BLOBCRED」と入力。
- DUMPFILE：コンテナーにアップロードしたダンプファイルのURLを指定。今回は、ダンプファイルが複数あるので「%L」パラメータを利用しています。
他のパラメータの詳細については、Oracle Data Pump ベストプラクティスを参照してください。
echo DIRECTORY=DATA_PUMP_DIR> impdp.par
echo SCHEMAS=HR >> impdp.par
echo CREDENTIAL=BLOBCRED >> impdp.par
echo PARALLEL=1 >> impdp.par
echo DUMPFILE=https://adb.blob.core.windows.net/adb-container/export_hr_%U.dmp >> impdp.par
echo LOGFILE=blobimp.log >> impdp.par
echo EXCLUDE=cluster,indextype,db_link >> impdp.par
echo METRICS=y >> impdp.par
echo LOGTIME=all >> impdp.par
そして、実際にパラメータファイルが作られているか確認するために以下のコマンドで確かめます。
type impdp.par
DIRECTORY=DATA_PUMP_DIR
SCHEMAS=HR
CREDENTIAL=BLOBCRED
PARALLEL=1
DUMPFILE=https://adb.blob.core.windows.net/adb-container/export_hr_%U.dmp
LOGFILE=blobimp.log
EXCLUDE=cluster,indextype,db_link
METRICS=y
LOGTIME=all
4⃣Data Pumpによるインポートを実行
Instant Clientと同じフォルダで、以下内容を自身の内容に書き換えて入力します。
今回のフォルダは、「C:\Users\ADB\Downloads\instantclient-basiclite-windows.x64-23.7.0.25.01\instantclient_23_7」です。
ちなみに、「TNSサービス名」に関しては、OCIコンソール上のADBの画面から確認することが可能です。今回は、「Oracleadb_high」を選択しますが、詳細に関してはこちらをご確認ください。
impdp admin/<ADBパスワード>@<TNSサービス名> parfile=impdp.par
【実行結果はこちら】
Import: Release 23.0.0.0.0 - Production on Sat Apr 19 10:46:20 2025
Version 23.7.0.25.01
Copyright (c) 1982, 2025, Oracle and/or its affiliates. All rights reserved.
Connected to: Oracle Database 23ai Enterprise Edition Release 23.0.0.0.0 - for Oracle Cloud and Engineered Systems
19-APR-25 10:46:37.347: W-1 Startup on instance 3 took 2 seconds
19-APR-25 10:46:41.339: W-1 Master table "ADMIN"."SYS_IMPORT_SCHEMA_01" successfully loaded/unloaded
19-APR-25 10:46:42.335: Starting "ADMIN"."SYS_IMPORT_SCHEMA_01": admin/********@oracleadb_high parfile=impdp.par
19-APR-25 10:46:42.438: W-1 Processing object type SCHEMA_EXPORT/USER
19-APR-25 10:46:42.757: W-1 Completed 1 USER objects in 0 seconds
19-APR-25 10:46:42.757: W-1 Processing object type SCHEMA_EXPORT/SYSTEM_GRANT
19-APR-25 10:46:42.852: W-1 Completed 7 SYSTEM_GRANT objects in 0 seconds
19-APR-25 10:46:42.852: W-1 Processing object type SCHEMA_EXPORT/ROLE_GRANT
19-APR-25 10:46:43.070: W-1 Completed 1 ROLE_GRANT objects in 1 seconds
19-APR-25 10:46:43.070: W-1 Processing object type SCHEMA_EXPORT/DEFAULT_ROLE
19-APR-25 10:46:43.259: W-1 Completed 1 DEFAULT_ROLE objects in 0 seconds
19-APR-25 10:46:43.259: W-1 Processing object type SCHEMA_EXPORT/TABLESPACE_QUOTA
19-APR-25 10:46:43.484: W-1 Completed 1 TABLESPACE_QUOTA objects in 0 seconds
19-APR-25 10:46:43.484: W-1 Processing object type SCHEMA_EXPORT/PASSWORD_HISTORY
19-APR-25 10:46:43.572: W-1 Completed 1 PASSWORD_HISTORY objects in 0 seconds
19-APR-25 10:46:43.790: W-1 Processing object type SCHEMA_EXPORT/SEQUENCE/SEQUENCE
19-APR-25 10:46:43.942: W-1 Completed 3 SEQUENCE objects in 0 seconds
19-APR-25 10:46:43.942: W-1 Processing object type SCHEMA_EXPORT/TABLE/TABLE
19-APR-25 10:46:45.891: W-1 Completed 8 TABLE objects in 2 seconds
19-APR-25 10:46:45.916: W-1 Processing object type SCHEMA_EXPORT/TABLE/TABLE_DATA
19-APR-25 10:46:47.117: W-1 . . imported "HR"."EMPLOYEES" 8.7 KB 107 rows in 0 seconds using external_table
19-APR-25 10:46:47.470: W-1 . . imported "HR"."LOCATIONS" 6 KB 23 rows in 0 seconds using external_table
19-APR-25 10:46:47.812: W-1 . . imported "HR"."JOB_HISTORY" 5.3 KB 10 rows in 0 seconds using external_table
19-APR-25 10:46:48.154: W-1 . . imported "HR"."JOBS" 5.4 KB 19 rows in 1 seconds using external_table
19-APR-25 10:46:48.497: W-1 . . imported "HR"."DEPARTMENTS" 5.4 KB 27 rows in 0 seconds using external_table
19-APR-25 10:46:48.923: W-1 . . imported "HR"."COUNTRIES" 5.2 KB 25 rows in 0 seconds using external_table
19-APR-25 10:46:49.258: W-1 . . imported "HR"."REGIONS" 4.9 KB 4 rows in 1 seconds using external_table
19-APR-25 10:46:49.277: W-1 . . imported "HR"."NG_TAB_4ADW" 0 KB 0 rows in 0 seconds using external_table
19-APR-25 10:46:49.288: W-1 Processing object type SCHEMA_EXPORT/TABLE/COMMENT
19-APR-25 10:46:49.515: W-1 Completed 39 COMMENT objects in 0 seconds
19-APR-25 10:46:49.515: W-1 Processing object type SCHEMA_EXPORT/PROCEDURE/PROCEDURE
19-APR-25 10:46:49.619: W-1 Completed 2 PROCEDURE objects in 0 seconds
19-APR-25 10:46:49.619: W-1 Processing object type SCHEMA_EXPORT/PROCEDURE/ALTER_PROCEDURE
19-APR-25 10:46:49.811: W-1 Completed 2 ALTER_PROCEDURE objects in 0 seconds
19-APR-25 10:46:49.811: W-1 Processing object type SCHEMA_EXPORT/VIEW/VIEW
19-APR-25 10:46:50.034: W-1 Completed 1 VIEW objects in 1 seconds
19-APR-25 10:46:50.093: W-1 Processing object type SCHEMA_EXPORT/TABLE/INDEX/INDEX
19-APR-25 10:46:50.591: W-1 Completed 17 INDEX objects in 0 seconds
19-APR-25 10:46:50.591: W-1 Processing object type SCHEMA_EXPORT/TABLE/CONSTRAINT/CONSTRAINT
19-APR-25 10:46:50.935: W-1 Completed 9 CONSTRAINT objects in 0 seconds
19-APR-25 10:46:50.935: W-1 Processing object type SCHEMA_EXPORT/TABLE/INDEX/STATISTICS/INDEX_STATISTICS
19-APR-25 10:46:50.959: W-1 Completed 19 INDEX_STATISTICS objects in 0 seconds
19-APR-25 10:46:50.959: W-1 Processing object type SCHEMA_EXPORT/TABLE/CONSTRAINT/REF_CONSTRAINT
19-APR-25 10:46:51.321: W-1 Completed 10 REF_CONSTRAINT objects in 1 seconds
19-APR-25 10:46:51.321: W-1 Processing object type SCHEMA_EXPORT/TABLE/TRIGGER
19-APR-25 10:46:51.489: W-1 Completed 2 TRIGGER objects in 0 seconds
19-APR-25 10:46:51.489: W-1 Processing object type SCHEMA_EXPORT/TABLE/STATISTICS/TABLE_STATISTICS
19-APR-25 10:46:51.513: W-1 Completed 8 TABLE_STATISTICS objects in 0 seconds
19-APR-25 10:46:51.543: W-1 Completed 1 [internal] STATISTICS objects in 0 seconds
19-APR-25 10:46:51.635: W-1 Completed 8 SCHEMA_EXPORT/TABLE/TABLE_DATA objects in 3 seconds
19-APR-25 10:46:51.743: Job "ADMIN"."SYS_IMPORT_SCHEMA_01" successfully completed at Sat Apr 19 10:46:51 2025 elapsed 0 00:00:24
5⃣データがインポートできているか確認
最後に、実際にデータ移行ができているか確認するために、Database Actionsで確認してみます。
例として、以下のコマンドで、HRスキーマのCOUNTRIES表の件数を見てみます。25件であれば大丈夫です！
select count(1) from hr.COUNTRIES;
COUNT(1)
----------
25
まとめ
今回は、Oracle Database@AzureのADBへData Pumpによる移行作業を実施しました。
他にもOracleのマルチクラウドに関する記事を発信しているので、以下の関連記事も合わせてご参考ください。
関連記事
Oracle Database@Azureに関して
- Oracle Database@Azureについてまとめてみた
- Oracle Database@AzureをPAYGで利用する手順
- Oracle Database@AzureでADBをプロビジョニングしてみた
- Oracle Database@AzureでADBのDatabase Actionsに接続してみた
- Oracle Database@AzureのADBへData Pumpで移行してみた
- Oracle Database@Azureでのリージョン数のService Limit引き上げ方法
- Oracle Database@AzureでExaDB-XSをプロビジョニングしてみた
- Oracle Database@AzureのExaDB-XSへData Pumpで移行してみた
Oracle Database@AWSに関して
編集履歴
- 2025/04/19 記事公開