指定されたオプションセットでダンプされる内容、および MySQL Database Service の互換性チェックの結果 (ocimds オプションが指定されている場合) に関する情報を表示しますが、ダンプは続行しません。 このオプションを設定すると、ダンプを開始する前に互換性の問題をすべてリストできます。 デフォルトは 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 インスタンスへの独自の接続を持ちます。 デフォルトは 4 です。

ダンプ中のデータ読取りスループットのスレッド当たりの最大バイト数/秒。 単位接尾辞 k (キロバイト)、M (メガバイト)、および G (ギガバイト) を使用できます (たとえば、100M を設定すると、スループットがスレッド当たり 100 メガバイト/秒に制限されます)。 0 (デフォルト値) を設定するか、オプションを空の文字列に設定すると、制限は設定されません。

ダンプの進行状況情報を表示 (true) または非表示 (false) にします。 MySQL Shell が対話型モードの場合など、stdout が端末 (tty) の場合、デフォルトは true です。それ以外の場合は false です。 進捗情報には、ダンプされる行の推定合計数、これまでにダンプされた行数、完了率およびスループット (行およびバイト/秒) が含まれます。

ダンプのデータファイルを書き込むときに使用する圧縮タイプ。 デフォルトでは、zstd 圧縮 (zstd) が使用されます。 または、gzip 圧縮 (gzip) を使用するか、圧縮なし (none) を使用します。

(インスタンスダンプユーティリティのみ)ダンプから名前付きスキーマを除外します。 information_schema, mysql, ndbinfo, performance_schema および sys スキーマは、常にインスタンスダンプから除外されることに注意してください。 名前付きスキーマが存在しないか除外されている場合、ユーティリティはその項目を無視します。

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

(テーブルダンプユーティリティのみ) このオプションを true に設定すると、指定したスキーマのすべてのビューおよびテーブルがダンプに含まれます。 このオプションを使用する場合は、tables パラメータを空の配列に設定します。 デフォルトは false です。

(インスタンスダンプユーティリティのみ) Include (true) または exclude (false) ユーザーとそのロールおよび権限をダンプに含めます。 デフォルトは true であるため、ユーザーはデフォルトで含まれます。 スキーマダンプユーティリティおよびテーブルダンプユーティリティでは、ダンプにユーザー、ロールおよび権限は含まれません。 MySQL Shell 8.0.22 から、excludeUsers または includeUsers オプションを使用して、ダンプファイルに除外または含める個々のユーザーアカウントを指定できます。 これらのオプションを MySQL Shell ダンプロードユーティリティ util.loadDump() とともに使用して、ターゲットの MySQL インスタンスの要件に応じて、インポート時に個々のユーザーアカウントを除外または含めることもできます。

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

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

ダンプ内の各スキーマに対する(インスタンスダンプユーティリティおよびスキーマダンプユーティリティのみ) include (true) または exclude (false) イベント。 デフォルトは true です。

ダンプ内の各スキーマに対する(インスタンスダンプユーティリティおよびスキーマダンプユーティリティのみ) include (true) または exclude (false) 関数およびストアドプロシージャ。 デフォルトは true です。 routines が true に設定されている場合でも、ユーザー定義関数は含まれないことに注意してください。

ダンプ内の各テーブルに (true) トリガーを含めるか、(false) トリガーを除外します。 デフォルトは true です。

ダンプのために MySQL Shell によってサーバーに開かれるセッション接続中に使用される文字セット。 デフォルトは utf8mb4 です。 システム変数 character_set_client、character_set_connection および character_set_results のセッション値は、接続ごとにこの値に設定されます。 文字セットは、character_set_client システム変数で許可され、MySQL インスタンスでサポートされている必要があります。

ダンプの先頭にステートメントを含めて、タイムゾーンを UTC に設定します。 ダンプ出力のすべてのタイムスタンプデータは、このタイムゾーンに変換されます。 デフォルトは true であるため、タイムスタンプデータはデフォルトで変換されます。 タイムゾーンを UTC に設定すると、異なるタイムゾーンを持つサーバー間でのデータの移動や、複数のタイムゾーンを持つ一連のデータの処理が容易になります。 必要に応じて元のタイムスタンプを保持するには、このオプションを false に設定します。

ダンプ中にインスタンスをバックアップ用にロックして、一貫性のあるデータダンプを有効 (true) または無効 (false) にします。 デフォルトは true です。 true が設定されている場合、ユーティリティは FLUSH TABLES WITH READ LOCK ステートメントを使用してグローバル読取りロックを設定します。 各スレッドのトランザクションは、SET SESSION TRANSACTION ISOLATION LEVEL REPEATABLE READ および START TRANSACTION WITH CONSISTENT SNAPSHOT ステートメントを使用して開始されます。 すべてのスレッドがトランザクションを開始すると、インスタンスはバックアップ用にロックされ、グローバル読取りロックが解放されます。

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

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

各テーブルのデータを複数のファイルに分割するテーブルデータのチャンク化を有効 (true) または無効 (false) にします。 デフォルトは true であるため、チャンク化はデフォルトで有効になっています。 bytesPerChunk を使用してチャンクサイズを指定します。 テーブルデータを別々のファイルにチャンク化するには、テーブルに対して主キーまたは一意インデックスを定義する必要があります。このテーブルは、データを順序付けおよびチャンク化するインデックスカラムを選択するためにユーティリティで使用されます。 テーブルにこれらのいずれも含まれていない場合は、警告が表示され、テーブルデータが単一のファイルに書き込まれます。 チャンクオプションを false に設定した場合、チャンクは実行されず、ユーティリティによってテーブルごとに 1 つのデータファイルが作成されます。

チャンクが有効な場合に各データファイルに書き込まれるおおよそのバイト数を設定します。 単位接尾辞 k(キロバイト)、M(メガバイト)、G(ギガバイト) を使用できます。 デフォルトは MySQL Shell 8.0.22 ( MySQL Shell 8.0.21 では 32 MB) からの 64 MB (64M) で、最小は 128 KB (128k) です。 このオプションを指定すると、chunking は暗黙的に true に設定されます。 このユーティリティは、圧縮が適用される前に、各テーブルのデータをこの量のデータを含むファイルにチャンク化することを目的としています。 チャンクサイズは平均で、テーブル統計および実行計画の見積りに基づいて計算されます。

このオプションを true に設定すると、MySQL Database Service との互換性のチェックおよび変更が可能になります。 デフォルトは false です。 MySQL Shell 8.0.23 からは、このオプションはすべてのユーティリティで使用でき、そのリリースより前は、インスタンスダンプユーティリティおよびスキーマダンプユーティリティでのみ使用できます。

このオプションが true, DATA DICTIONARY, INDEX DICTIONARY に設定され、CREATE TABLE ステートメントの ENCRYPTION オプションが DDL ファイルでコメントアウトされている場合、すべてのテーブルが MySQL データディレクトリに配置され、デフォルトのスキーマ暗号化が使用されるようにします。 チェックは、InnoDB 以外の CREATE TABLE ステートメント内のストレージエンジン、ユーザーまたはロールへの不適切な権限の付与、およびその他の互換性の問題に対して実行されます。 非準拠の SQL ステートメントが見つかった場合は、例外が発生し、ダンプが停止されます。 ダンププロセスが開始される前に、dryRun オプションを使用してダンプ内の項目に関するすべての問題をリストします。 compatibility オプションを使用して、ダンプ出力の問題を自動的に修正します。

MySQL Shell 8.0.22 から、このオプションが true に設定され、osBucketName オプションを使用してオブジェクトストレージバケット名が指定されている場合、ociParManifest オプションもデフォルトで true に設定されます。つまり、ダンプ内のすべての項目に対して事前認証済リクエストが生成され、これらのリクエスト URL を使用してのみダンプファイルにアクセスできます。

ダンプ出力のすべてのテーブルに MySQL Database Service との互換性のために指定された要件を適用し、ダンプファイルを necessary.From MySQL Shell 8.0.23 として変更します。このオプションはすべてのユーティリティで使用でき、そのリリースより前は、インスタンスダンプユーティリティおよびスキーマダンプユーティリティでのみ使用できます。

次の変更は、カンマ区切りリストとして指定できます:

このオプションを true に設定すると、ダンプ内のすべてのアイテムに対する読取りアクセスの事前認証済リクエスト (オブジェクト読取り PAR) と、すべての事前認証済リクエスト URL をリストするマニフェストファイルが生成されます。 事前認証済リクエストは、デフォルトで 1 週間後に期限切れになります。これは、ociParExpireTime オプションを使用して変更できます。

このオプションは MySQL Shell 8.0.22 から使用でき、(osBucketName オプションを設定して) オブジェクトストレージバケットにエクスポートする場合にのみ使用できます。 MySQL Shell 8.0.23 からは、このオプションはすべてのユーティリティで使用でき、MySQL Shell 8.0.22 では、インスタンスダンプユーティリティおよびスキーマダンプユーティリティでのみ使用できます。

ocimds オプションが true に設定され、osBucketName オプションを使用してオブジェクトストレージバケット名が指定されている場合、ociParManifest はデフォルトで true に設定され、それ以外の場合はデフォルトで false に設定されます。

オブジェクトストレージバケットへの接続に使用される Oracle Cloud Infrastructure プロファイルで指定されたユーザー (DEFAULT ユーザーまたは ociProfile オプションで指定された別のユーザー) は、事前認証済リクエストの作成者です。 このユーザーには、「事前認証済リクエストの使用」で説明されているように、バケット内のオブジェクトと対話するための PAR_MANAGE 権限および適切な権限が必要です。 オブジェクトの事前認証済リクエスト URL の作成に問題がある場合は、関連付けられたファイルが削除され、ダンプが停止されます。

生成されたダンプファイルをロードできるようにするには、「事前認証済リクエストの使用」の手順に従って、マニフェストファイルオブジェクト (@.manifest.json) の事前認証済読取りリクエストを作成します。 ダンプが完了する前にダンプのロードを開始する場合は、ダンプの進行中にこれを実行できます。 必要な権限を持つユーザーアカウントを使用して、この事前認証済読取りリクエストを作成できます。 その後、事前認証済リクエスト URL をダンプロードユーティリティで使用して、マニフェストファイルを介してダンプファイルにアクセスする必要があります。 URL は作成時にのみ表示されるため、永続記憶域にコピーします。

ociParManifest オプションが true に設定されている場合に生成される事前認証済リクエスト URL の有効期限。 デフォルトは、UTC 形式の現在の時間に 1 週間を加えたものです。

このオプションは、MySQL Shell 8.0.22 から使用できます。 MySQL Shell 8.0.23 からは、このオプションはすべてのユーティリティで使用でき、MySQL Shell 8.0.22 では、インスタンスダンプユーティリティおよびスキーマダンプユーティリティでのみ使用できます。

有効期限は、事前認証済リクエストの作成時に Oracle Cloud Infrastructure で必要とされる RFC 3339 タイムスタンプとして書式設定する必要があります。 書式は、YYYY-MM-DDTHH-MM-SS の直後に文字 Z (UTC 時間の場合) または[+|-]hh:mm で表されるローカル時間の UTC オフセット (2020-10-01T00:09:51.000+02:00 など) が続きます。MySQL Shell では有効期限は検証されませんが、フォーマットエラーにより、ダンプ内の最初のファイルに対する事前認証済リクエストの作成が失敗し、ダンプが停止されます。