本記事では、OB Cloudデータベースコンソールを使用してダイレクトロードのインポートポートを有効または無効にする方法について説明します。
概要
OB Cloudデータベースは、ダイレクトロードのインポート方式でデータをデータベースに挿入することをサポートしています。この機能は従来のSQL層インターフェースをバイパスし、データベースのファイルに直接データを書き込むことで、データインポートの効率を向上させます。詳細については、ダイレクトロードのインポートの概要をご参照ください。
前提条件
ダイレクトロードのインポートを使用する際は、以下の点を確認してください。以下のすべての条件を満たしている場合にのみ、ダイレクトロードのインポートポートを有効にする操作を実行できます。
クラスタインスタンスに対する読み取りおよび書き込み権限が付与されていること。
現在のクラスタがトランザクション型インスタンスであり、実行中の状態にあること。
現在のテナントが実行中の状態にあること。
プライベートネットワークアドレスが実行中であること。
ダイレクトロードのインポートを有効にする
OB Cloudデータベースコンソールにログインします。
**インスタンスページで、対象のクラスタインスタンス名をクリックし、概要**に移動します。
左側のナビゲーションペインで、**プロキシ**をクリックします。
**データベースプロキシページのプライベートネットワークアドレスエリアで、ダイレクトロード用ポート:の右側にあるオン**をクリックします。
二度目の確認ポップアップウィンドウで、**OK**をクリックします。
データのインポート
最新バージョンのOceanBaseデータ導入ツールをダウンロードします。
OceanBaseデータ導入ツールの詳細については、製品紹介をご参照ください。
環境変数を確認し、設定します。
JavaおよびPATHに関連する環境変数を確認します。
[root@iZbxxxx rpc]# env | grep JAVA JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.382.b05-2.0.3.al8.x86_64 [root@iZbxxxx rpc]# env | grep PATH PATH=/root/ob-loader-dumper-4.3.0-RELEASE/bin/:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/root/binJavaおよびPATH環境変数を設定します。
[root@iZbxxxx rpc]# export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.382.b05-2.0.3.al8.x86_64 [root@iZbxxxx rpc]# export PATH=/root/ob-loader-dumper-4.3.0-RELEASE/bin/:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/root/bin:$PATH
ダイレクトロード方式でデータをインポートします。
説明
インポートするファイルの内容形式は規格に準拠している必要があります。詳細については、データインポートでサポートされているファイル形式とエンコーディング形式をご参照ください。
[root@iZbxxxx rpc]# obloader -h<host> -u<user_name> -p<pass_word> -D <db_name> --table '<table_name>' -f output1 -t <tenant_name> --public-cloud --csv --direct --rpc-port 3307 -P3306パラメータ説明-h OceanBaseデータベースのホストアドレスを指定します。 -u OceanBaseデータベースへの接続に使用するユーザー名、テナント名、クラスタ名。形式は <user>@<tenant>#<cluster>です。例：-u user@tenant#cluster。-p OceanBaseデータベースに接続するユーザーのパスワードを指定します。 -D データベースオブジェクト定義とテーブルデータをインポートするOceanBaseデータベースの名前を指定します。 --table OceanBaseデータベース内の指定したテーブルに対して操作を実行します。例： --table 'example'。-f インポート対象ファイル名のプレフィックスを指定します。例：このコマンドは、インポートするデータが output1をプレフィックスとするファイルに保存されていることを意味します。-t このパラメータは --public-cloudと組み合わせて使用し、OceanBaseデータベースに接続するテナント名を指定します。--public-cloud クラウドデータベースOceanBaseからデプロイされたOceanBaseクラスタからデータベースオブジェクトまたはテーブルデータをインポートすることを示します。 --csv インポートするデータファイルの形式をCSVと指定します。インポートするデータの実際の形式に応じて、例えば --sql、--par、--orcなどを指定できます。--direct ダイレクトロードモードを使用することを指定します。このパラメータは --rpc-port、--parallelと組み合わせて使用します。--parallel ダイレクトロード時のデータ読み込み並列度を指定します。このパラメータはオプションで、デフォルト値は1です。 --rpc-port、--directと組み合わせて使用します。--rpc-port 3307 OBServer RPCに接続するポートを指定します。データベース接続ポートが3306(-P3306で指定)であるにもかかわらず、実際のデータインポートは3307ポートのRPCサービスを介して行われることを示し、インポート性能を向上させます。 -P 3306 OceanBaseデータベースに接続するホストポートを指定します。
ダイレクトロードを無効にする
OB Cloudクラウドデータベースコンソールにログインします。
**インスタンスページで、対象クラスタインスタンスの名前をクリックし、概要**に入ります。
左側のナビゲーションペインで、**データベースプロキシ**をクリックします。
**データベースプロキシページのメインアドレスのプライベートネットワークアドレス領域で、ダイレクトロードのポートの右側にある閉じる**をクリックします。
注意
ダイレクトロードポートを無効にする前に、そのポートに他のサービスが接続されていないことを確認してください。
二度目の確認ポップアップで、**OK**をクリックします。