ダンプの内容に基づいて返されるが、インポートを続行しないエラーを含む、指定されたオプションおよびダンプファイルで実行されるアクションに関する情報を表示します。 デフォルトは false です。

ダンプファイルがある Oracle Cloud Infrastructure Object Storage バケットの名前。 デフォルトでは、~/.oci/config にある Oracle Cloud Infrastructure CLI 構成ファイルの[DEFAULT]プロファイルを使用して、バケットへの接続が確立されます。 ociConfigFile および ociProfile オプションを使用して、接続に使用される代替プロファイルを置換できます。 CLI 構成ファイルの設定手順については、「SDK および CLI 構成ファイル」を参照してください。

osBucketName によって指定されたオブジェクトストレージバケットが配置される Oracle Cloud Infrastructure ネームスペース。 オブジェクトストレージバケットのネームスペースは、Oracle Cloud Infrastructure コンソールのバケット詳細ページの「バケット情報」タブに表示されるか、Oracle Cloud Infrastructure コマンドラインインタフェースを使用して取得できます。

デフォルトの場所の ~/.oci/config ではなく、接続に使用するプロファイルを含む Oracle Cloud Infrastructure CLI 構成ファイル。

接続に使用される Oracle Cloud Infrastructure CLI 構成ファイル内の[DEFAULT]プロファイルではなく、接続に使用する Oracle Cloud Infrastructure プロファイルのプロファイル名。

データのチャンクをターゲット MySQL インスタンスにアップロードするために使用するパラレルスレッドの数。 各スレッドは、MySQL インスタンスへの独自の接続を持ちます。 ダンプがチャンク化を有効にして作成された場合 (デフォルト)、ユーティリティは複数のスレッドを使用してテーブルのデータをロードできます。それ以外の場合、スレッドは 1 つのテーブルにのみ使用されます。

ダンプロードユーティリティの進捗状態ファイルのローカルファイルの場所。インポートの進捗状態を保持します。 デフォルトでは、進捗状態ファイルは load-progress.server_uuid.json という名前でダンプディレクトリに作成されますが、このオプションを使用して変更できます。 progressFile を空の文字列に設定すると、進行状況の追跡が無効になります。つまり、ダンプロードユーティリティは部分的に完了したインポートを再開できません。

インポートの進行状況情報を表示 (true) または非表示 (false) します。 MySQL Shell が対話型モードの場合など、stdout が端末 (tty) の場合、デフォルトは true です。それ以外の場合は false です。 進捗情報には、アクティブスレッドの数とそのアクション、これまでにロードされたデータの量、完了率およびスループット率が含まれます。 進捗情報が表示されない場合でも、進捗状態はダンプロードユーティリティの進捗状態ファイルに記録されます。

このオプションを true に設定すると、進行状態がリセットされ、インポートが最初から再開されます。 デフォルトは false です。 このオプションでは、ダンプロードユーティリティはすでに作成されているオブジェクトをスキップせず、重複除外を管理しないことに注意してください。 このオプションを使用する場合は、正しいインポートを確実にするために、まず、以前にロードされたすべてのオブジェクト (スキーマ、テーブル、ユーザー、ビュー、トリガー、ルーチン、イベントなど) をターゲット MySQL インスタンスから手動で削除する必要があります。 それ以外の場合、ダンプファイル内のオブジェクトがターゲット MySQL インスタンスにすでに存在すると、インポートはエラーで停止します。 適切な注意が必要な場合は、ignoreExistingObjects オプションを使用してユーティリティレポートでオブジェクトを複製しますが、スキップしてインポートを続行できます。

このオプションを設定すると、ダンプの場所にアップロードされたすべてのデータチャンクが処理された後、ユーティリティがそれ以降のデータを待機するタイムアウト (秒) を指定することで、同時ロードがアクティブ化されます。 これにより、作成中のダンプをユーティリティでインポートできます。 データは使用可能になると処理され、ダンプの場所にデータが表示されずにタイムアウトを超えるとインポートは停止します。 デフォルト設定の 0 は、アップロードされたすべてのデータチャンクが処理され、それ以上のデータを待機しない場合に、ユーティリティがダンプを完了としてマークすることを意味します。

MySQL インスタンスのターゲットスキーマにすでに存在するオブジェクトが含まれている場合でも、ダンプをインポートします。 デフォルトは false です。つまり、インポートが進行状態ファイルを使用した前回の試行から再開されないかぎり、エラーが発行され、重複オブジェクトが検出されるとインポートが停止します。この場合、チェックはスキップされます。 このオプションを true に設定すると、重複オブジェクトがレポートされますが、エラーは生成されず、インポートは続行されます。 ユーティリティでは、ターゲット MySQL インスタンスとダンプファイルのオブジェクトの内容が異なるかどうかはチェックされないため、このオプションは注意して使用する必要があります。そのため、インポート結果に不正または無効なデータが含まれる可能性があります。 別の方法として、excludeTables オプションを使用して、ダンプファイル内のオブジェクトがターゲット MySQL インスタンス内のインポート済オブジェクトと同じであることを確認したときにすでにロードしたテーブルを除外する方法もあります。 ダンプを再起動する前に、重複するオブジェクトをターゲット MySQL インスタンスから削除することをお薦めします。

データのダンプ元の MySQL インスタンスのメジャーバージョン番号が、データのアップロード先の MySQL インスタンスのメジャーバージョン番号と異なる場合でも、ダンプをインポートします。 デフォルトは false で、メジャーバージョン番号が異なる場合、エラーが発行され、インポートは続行されません。 このオプションを true に設定すると、警告が発行され、インポートが続行されます。 インポートは、ダンプファイル内のスキーマに新しいメジャーバージョンとの互換性の問題がない場合にのみ成功することに注意してください。

MySQL Shell 8.0.23 からは、このオプションを使用して、ocimds オプションを使用せずに作成されたダンプを MySQL Database Service インスタンスにインポートすることもできます。

ignoreVersion オプションを使用してインポートを試行する前に、MySQL Shell アップグレードチェッカユーティリティ checkForServerUpgrade() を使用して、ソース MySQL インスタンスのスキーマを確認します。 スキーマをダンプしてターゲット MySQL インスタンスにインポートする前に、ユーティリティで特定された互換性の問題を修正します。

ダンプメタデータに記録されているソース MySQL インスタンスの gtid_executed GTID セットを、ターゲット MySQL インスタンスの gtid_purged GTID セットに適用します。 gtid_purged GTID セットは、サーバーに適用されたが、サーバー上のバイナリログファイルには存在しないすべてのトランザクションの GTID を保持します。 このオプションは MySQL Shell 8.0.22 から使用できますが、そのリリースでは、権限の制限のため、MySQL DB システムではサポートされていません。 MySQL 8.0.23 から、このオプションを MySQL DB システムインスタンスにも使用できます。 デフォルトは off で、GTID セットが適用されないことを意味します。

このオプションは、MySQL Shell インスタンスダンプユーティリティまたはスキーマダンプユーティリティによって生成されたダンプに対してのみ、MySQL Shell テーブルダンプユーティリティによって生成されたダンプには使用しないでください。 また、グループレプリケーションがターゲットの MySQL インスタンスで実行されている場合は、このオプションを使用しないでください。

MySQL DB システムインスタンスではない MySQL インスタンスの場合、GTID セットを更新するために append または replace を設定するときに、skipBinlog オプションも true に設定します。 これにより、ソースサーバー上の GTID がターゲットサーバー上の GTID と一致することが保証されます。 MySQL DB システムインスタンスの場合、このオプションは使用されません。

MySQL 8.0 のターゲット MySQL インスタンスの場合、オプションを append に設定できます。これにより、ソース MySQL インスタンスの gtid_executed GTID セットがターゲット MySQL インスタンスの gtid_purged GTID セットに追加されます。 適用する gtid_executed GTID セットは、@.json ダンプファイルの gtidExecuted フィールドに表示され、ターゲット MySQL インスタンスにすでに存在する gtid_executed セットと交差しないようにする必要があります。 たとえば、別のソース MySQL インスタンスから、他のソースサーバーのスキーマをすでに持つターゲット MySQL インスタンスにスキーマをインポートする場合に、このオプションを使用できます。

MySQL 8.0 のターゲット MySQL インスタンスに replace を使用して、ターゲット MySQL インスタンスの gtid_purged GTID セットをソース MySQL インスタンスの gtid_executed GTID セットに置き換えることもできます。 これを行うには、ソース MySQL インスタンスの gtid_executed GTID セットがターゲット MySQL インスタンスの gtid_purged GTID セットのスーパーセットであり、gtid_purged GTID セットにないターゲット gtid_executed GTID セットのトランザクションのセットと交差していない必要があります。

MySQL 5.7 のターゲット MySQL インスタンスの場合、オプションを replace に設定します。これにより、ターゲット MySQL インスタンスに設定されている gtid_purged GTID が、ソース MySQL インスタンスの gtid_executed GTID セットに置き換えられます。 MySQL 5.7 でこれを行うには、ターゲット MySQL インスタンス上の gtid_executed および gtid_purged GTID セットが空である必要があるため、以前に GTID セットをインポートしていない状態でインスタンスを使用しないでください。

MySQL Shell 8.0.21 では、このオプションを使用できない場合、GTID セットを MySQL Server インスタンスに手動で適用できます (グループレプリケーションが使用されている場合を除く)。 MySQL DB システムの場合、この方法はサポートされていません。 GTID セットを適用するには、インポート後に、MySQL Shell\sql コマンドを使用して (または SQL モードを開始して)、接続された MySQL インスタンスで次のステートメントを発行し、ダンプメタデータの@.json ダンプファイルの gtidExecuted フィールドから gtid_executed GTID セットをコピーします:

shell-js> \sql SET @@GLOBAL.gtid_purged= "+gtidExecuted_set";

このステートメントは、MySQL 8.0 から機能し、ソース MySQL Server インスタンス gtid_executed GTID セットをターゲット MySQL インスタンス gtid_purged GTID セットに追加します。 MySQL 5.7 の場合、プラス記号 (+) は省略する必要があり、ターゲット MySQL インスタンスの gtid_executed および gtid_purged GTID セットは空である必要があります。 詳細は、ターゲット MySQL インスタンスのリリースにおける gtid_purged システム変数の説明を参照してください。

SET sql_log_bin=0 ステートメントを発行して、インポート中にユーティリティで使用されるセッションのターゲット MySQL インスタンスでバイナリロギングをスキップします。 デフォルトは false であるため、バイナリロギングはデフォルトでアクティブです。 MySQL DB システムの場合、このオプションは使用されず、true に設定しようとするとインポートはエラーで停止します。 他の MySQL インスタンスの場合、updateGtidSet オプションを使用するか手動で、ソース MySQL インスタンスから gtid_executed GTID セットをターゲット MySQL インスタンスに適用する場合は、常に skipBinlog を true に設定します。 GTID がターゲット MySQL インスタンス (gtid_mode=ON) で使用されている場合、このオプションを true に設定すると、インポートの実行中に新しい GTID が生成および割り当てられないため、ソースサーバーから設定された元の GTID を使用できます。 ユーザーアカウントには、sql_log_bin システム変数の設定に必要な権限が必要です。

テーブルのセカンダリインデックスを作成 (true) するか、作成 (false) しないでください。 デフォルトは true です。 このオプションが false に設定されている場合、セカンダリインデックスはインポート中に作成されないため、後で作成する必要があります。 これは、DDL ファイルとデータファイルを個別にロードする場合、および DDL ファイルのロード後にテーブル構造を変更する場合に便利です。 その後、loadIndexes を true に設定し、deferTableIndexes を all に設定してダンプロードユーティリティを再度実行することで、セカンダリインデックスを作成できます。

テーブルデータがロードされるまでセカンダリインデックスの作成を延期します。 これにより、ロード時間を短縮できます。off は、テーブルのロード中にすべてのインデックスが作成されることを意味します。 デフォルト設定の fulltext では、全文インデックスのみが遅延されます。all は、すべてのセカンダリインデックスを遅延し、テーブルのロード中にのみプライマリインデックスを作成します。また、自動インクリメント値を含むカラムに ( MySQL Shell 8.0.22 から) 定義されたインデックスも作成します。 MySQL Shell 8.0.21 では、自動増分値を含む一意のキーカラムがある場合、all を設定しないでください。

ロードされたテーブルに対して ANALYZE TABLE を実行します。on はすべてのテーブルを分析し、histogram はダンプにヒストグラム情報が格納されているテーブルのみを分析します。 デフォルトは off です。 このオプションを指定してダンプロードユーティリティを実行すると、データがすでにロードされている場合でもテーブルを分析できます。

LOAD DATA ステートメントの CHARACTER SET オプションなどで、ターゲット MySQL インスタンスへのインポートに使用される文字セット。 デフォルトは、ダンプが MySQL Shell インスタンスダンプユーティリティ、スキーマダンプユーティリティまたはテーブルダンプユーティリティによって作成されたときに使用されたダンプメタデータで指定された文字セットで、デフォルトでは utf8mb4 が使用されます。 文字セットは、character_set_client システム変数で許可され、MySQL インスタンスでサポートされている必要があります。

MySQL Shell テーブルダンプユーティリティによって生成されたダンプをロードする必要がある既存のターゲットスキーマ。

MySQL Shell 8.0.23 からは、テーブルダンプユーティリティのダンプファイルには、最初にテーブルが含まれていたスキーマの設定に必要な情報が含まれているため、このオプションは必要ありません。 デフォルトでは、そのリリースから、ターゲットの MySQL インスタンスにスキーマがまだ存在しない場合は再作成されます。 または、schema オプションを指定して、ターゲット MySQL インスタンスの代替スキーマにテーブルをロードできます。

MySQL Shell 8.0.22 では、テーブルダンプユーティリティのダンプファイルにスキーマ情報が含まれていないため、ターゲットスキーマがターゲットの MySQL インスタンスに存在する必要があります。 このリリースでは、デフォルトでグローバルシェルセッションの現在のスキーマがターゲットスキーマとして使用されるか、schema オプションを使用してターゲットスキーマを指定できます。

指定したスキーマをインポートから除外します。 information_schema, mysql, ndbinfo, performance_schema および sys スキーマは、常に MySQL Shell インスタンスダンプユーティリティによって作成されたダンプから除外されることに注意してください。 ダンプファイルに名前付きスキーマが存在しない場合、ユーティリティはその項目を無視します。

ダンプファイルから名前付きスキーマのみをロードします。 両方のオプションを指定できます。この場合、includeSchemas 文字列と excludeSchemas 文字列の両方で一致するスキーマ名は除外されます。

指定したテーブルをインポートから除外します。 テーブル名は、有効なスキーマ名で修飾し、必要に応じてバックティック文字で引用符で囲む必要があります。 mysql.apply_status, mysql.general_log, mysql.schema および mysql.slow_log tables のデータは、DDL ステートメントは含まれていますが、常に MySQL Shell スキーマダンプユーティリティによって作成されたダンプから除外されることに注意してください。 excludeTables オプションで指定されたテーブルは、ターゲットの MySQL インスタンスにアップロードされません。 指定したテーブルがスキーマに存在しない場合、またはスキーマがダンプファイルに存在しない場合、ダンプロードユーティリティは項目を無視します。

ダンプファイルから指定されたテーブルのみをロードします。 テーブル名は、有効なスキーマ名で修飾し、必要に応じてバックティック文字で引用符で囲む必要があります。 両方のオプションを指定できます。この場合、includeTables 文字列と excludeTables 文字列の両方で一致するテーブル名は除外されます。

このオプションを true に設定すると、ダンプから DDL ファイルのみがインポートされ、データはインポートされません。 デフォルトは false です。

このオプションを true に設定すると、ダンプからデータファイルのみがインポートされ、DDL ファイルはインポートされません。 デフォルトは false です。

(true) をインポートするか、(false) ユーザーとそのロールおよび権限をターゲットの MySQL インスタンスにインポートしないでください。 デフォルトは false であるため、ユーザーはデフォルトでインポートされません。 現在のユーザーのステートメントはスキップされます。 MySQL Shell 8.0.22 からは、ターゲットの MySQL インスタンスにユーザーがすでに存在する場合、エラーが返され、ダンプファイルからのユーザー権限は適用されません。 MySQL Shell 8.0.22 から、ダンプロードユーティリティの excludeUsers または includeUsers オプションを使用して、インポートに除外または含めるユーザーアカウントを指定できます。

MySQL Shell スキーマダンプユーティリティおよびテーブルダンプユーティリティでは、ダンプにユーザー、ロールおよび付与は含まれませんが、インスタンスダンプユーティリティではデフォルトで可能であり、実行できます。 MySQL Shell 8.0.22 から、excludeUsers および includeUsers オプションをインスタンスダンプユーティリティで使用して、ダンプファイルから名前付きユーザーアカウントを除外または含めることもできます。

true を指定したが、指定したダンプファイルにユーザーアカウントが含まれていない場合、MySQL Shell 8.0.23 の前に、ユーティリティはエラーを返してインポートを停止します。 MySQL Shell 8.0.23 からは、かわりにユーティリティは警告を返して続行します。

指定されたユーザーアカウントをインポートから除外します。 このオプションは MySQL Shell 8.0.22 から使用でき、これを使用して、MySQL DB システムへのインポートが許可されていないユーザーアカウント、またはターゲットの MySQL インスタンスにすでに存在するか不要なユーザーアカウントを除外できます。 各ユーザーアカウント文字列は、ユーザー名とホスト名で定義されたアカウントの場合は"'user_name'@'host_name'"の形式で、ユーザー名のみで定義されたアカウントの場合は"'user_name'" ("'user_name'@'%'"と同等) で指定します。 指定されたユーザーアカウントがダンプファイルに存在しない場合、ユーティリティは項目を無視します。

指定されたユーザーアカウントのみをインポートに含めます。 excludeUsers オプションの場合と同様に、各ユーザーアカウント文字列を指定します。 このオプションは MySQL Shell 8.0.22 から使用でき、ターゲット MySQL インスタンスで必要なユーザーアカウントが少ない場合は、excludeUsers のかわりに使用できます。 両方のオプションを指定することもできます。この場合、includeUsers 文字列と excludeUsers 文字列の両方で一致するユーザーアカウントは除外されます。