接続された MySQL サーバー上のターゲットデータベースの名前。 このオプションを省略すると、ユーティリティは、接続 URI 文字列、\use コマンドまたは MySQL Shell オプションで指定された、現在の MySQL Shell セッションで使用されているスキーマ名を識別して使用しようとします。 スキーマ名が指定されておらず、セッションから識別できない場合は、エラーが返されます。

ターゲットリレーショナルテーブルの名前。 このオプションを省略すると、テーブル名は拡張子のないデータファイルの名前とみなされます。 ターゲットテーブルがターゲットデータベースに存在する必要があります。

ターゲットリレーショナルテーブルのカラムにマップされた順序で指定された、インポートファイルのカラム名を含む文字列の配列。 このオプションは、インポートされたデータにターゲットテーブルのすべてのカラムが含まれていない場合、またはインポートされたデータのフィールドの順序がテーブルのカラムの順序と異なる場合に使用します。 このオプションを省略した場合、入力行にはターゲットテーブルの各カラムに一致するフィールドが含まれると想定されます。

MySQL Shell 8.0.22 からは、このオプションを使用して、LOAD DATA ステートメントの場合と同じ方法で、入力前処理のためにインポートファイルからカラムを取得できます。 配列内のカラム名のかわりに整数値を使用すると、インポートファイル内のそのカラムは、@1 などのユーザー変数@int として取得されます。 選択したデータを破棄するか、decodeColumns オプションを使用してデータを変換し、ターゲットテーブルのカラムに割り当てることができます。

MySQL ShellJavaScript モードのこの例では、インポートファイルの 2 番目と 4 番目のカラムがユーザー変数@1 および@2 に割り当てられ、ターゲットテーブルのどのカラムにも割り当てる decodeColumns オプションはないため、これらは破棄されます。

mysql-js> util.importTable('file.txt', {
            table: 't1',
            columns: ['column1', 1, 'column2', 2, 'column3']
          });

columns オプションによってユーザー変数として取得されたインポートファイルカラムをターゲットテーブルのカラムに割り当て、LOAD DATA ステートメントの SET 句と同じ方法で前処理変換を指定する、キーと値のペアのディクショナリ。 このオプションは、MySQL Shell 8.0.22 から使用できます。

MySQL ShellJavaScript モードのこの例では、データファイルの最初の入力カラムがターゲットテーブルの最初のカラムとして使用されます。 columns オプションによって変数@1 に割り当てられた 2 番目の入力カラムは、ターゲットテーブルの 2 番目のカラムの値として使用される前に除算操作の対象となります。

mysql-js> util.importTable('file.txt', {
            columns: ['column1', 1],
            decodeColumns: {'column2': '@1 / 100'}
          });

MySQL ShellJavaScript モードのこの例では、データファイルの入力カラムが両方とも変数に割り当てられ、様々な方法で変換されて、ターゲットテーブルのカラムへの移入に使用されます:

mysql-js> util.importTable('file.txt', {
            table: 't1',
            columns: [1, 2],
            decodeColumns: {
              'a': '@1',
              'b': '@2',
              'sum': '@1 + @2',
              'multiple': '@1 * @2',
              'power': 'POW(@1, @2)'
            }
          });

インポートファイルの先頭、または複数のインポートファイルの場合はファイルリストに含まれるすべてのファイルの先頭で、この数のデータ行をスキップします。 このオプションを使用して、アップロードからテーブルへのカラム名を含む初期ヘッダー行を省略できます。 デフォルトでは、行はスキップされません。

既存の行と同じ値または一意インデックスを持つ入力行を置換する (true) かスキップする (false) か。 デフォルトは false です。

指定したファイル形式に適した一連のフィールド処理および行処理オプションを使用します。 linesTerminatedBy, fieldsTerminatedBy, fieldsEnclosedBy, fieldsOptionallyEnclosed および fieldsEscapedBy オプションのいずれかまたは複数を指定して設定を変更することで、選択した言語をさらにカスタマイズするためのベースとして使用できます。 デフォルトの言語は、そのステートメントのデフォルト設定で SELECT...INTO OUTFILE ステートメントを使用して作成されたファイルにマップされます。 これは、MySQL Shell テーブルエクスポートユーティリティによって生成される出力ファイルのデフォルトです。 CSV ファイル (DOS または UNIX システムで作成)、TSV ファイルおよび JSON データに適したその他のダイアレクトを使用できます。 各言語に適用される設定は次のとおりです:

入力データファイルの各行を終了する 1 つ以上の文字 (または空の文字列)。 デフォルトは、指定された方言、または方言オプションが省略されている場合は改行文字 (\n) です。 このオプションは、LOAD DATA ステートメントの LINES TERMINATED BY オプションと同等です。 ユーティリティでは、空の文字列に設定されている LOAD DATA ステートメントの LINES STARTING BY オプションに相当するものは提供されないことに注意してください。

入力データファイルの各フィールドを終了する 1 つ以上の文字 (または空の文字列)。 デフォルトは、指定された言語、または言語オプションが省略されている場合はタブ文字 (\t) です。 このオプションは、LOAD DATA ステートメントの FIELDS TERMINATED BY オプションと同等です。

入力データファイルの各フィールドを囲む単一の文字 (または空の文字列)。 デフォルトは、指定された言語に対するものであり、dialect オプションが省略されている場合は空の文字列です。 このオプションは、LOAD DATA ステートメントの FIELDS ENCLOSED BY オプションと同等です。

fieldsEnclosedBy に指定された文字が入力データファイル (false) 内のすべてのフィールドを囲むか、場合によってのみフィールドを囲むか (true)。 デフォルトは、指定された言語、または dialect オプションが省略されている場合は false です。 このオプションにより、fieldsEnclosedBy オプションは LOAD DATA ステートメントの FIELDS OPTIONALLY ENCLOSED BY オプションと同等になります。

入力データファイル内のエスケープシーケンスを開始する文字。 これを指定しない場合、エスケープシーケンスの解釈は行われません。 デフォルトは、指定された言語の場合と同様です。または、dialect オプションが省略されている場合はバックスラッシュ (\)) です。 このオプションは、LOAD DATA ステートメントの FIELDS ESCAPED BY オプションと同等です。

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

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

MySQL Shell 8.0.21 に追加されました。 デフォルトの場所の ~/.oci/config ではなく、接続に使用するプロファイルを含む Oracle Cloud Infrastructure CLI 構成ファイル。

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

MySQL Shell 8.0.21 に追加されました。 このオプションでは、インポート時に入力データが解釈される文字セットエンコーディングを指定します。 このオプションを binary に設定すると、インポート中に変換は行われません。 このオプションを省略すると、インポートでは、character_set_database システム変数で指定された文字セットを使用して入力データが解釈されます。

複数の入力データファイルのリストの場合、このオプションは使用できません。 単一の入力データファイルの場合、このオプションでは、スレッドがターゲットサーバーへの LOAD DATA コールごとに送信するバイト数 (および行の終わりに到達するために必要な追加バイト数) を指定します。 このユーティリティは、スレッドがターゲットサーバーに取得して送信するために、データをこのサイズのチャンクに分散します。 チャンクサイズは、バイト数で指定するか、接尾辞 k (キロバイト)、M (メガバイト)、G (ギガバイト) を使用して指定できます。 たとえば、bytesPerChunk="2k"では、スレッドは約 2 キロバイトのチャンクを送信します。 最小チャンクサイズは 131072 バイトで、デフォルトのチャンクサイズは 50M です。

入力ファイルのデータをターゲットサーバーに送信するために使用するパラレルスレッドの最大数。 スレッド数を指定しない場合、デフォルトの最大値は 8 です。 複数の入力データファイルのリストについては、指定した数または最大数のスレッドが作成されます。 単一の入力データファイルの場合、ユーティリティは次の式を使用して、この最大数までの適切なスレッド数を計算します:

min{max{1, threads}, chunks}}

ここで、threads はスレッドの最大数、chunks はデータが分割されるチャンクの数で、ファイルサイズを bytesPerChunk サイズで除算してから 1 を加算して計算されます。 この計算により、スレッドの最大数が実際に送信されるチャンクの数を超えた場合、ユーティリティは必要以上のスレッドを作成しません。

圧縮されたファイルはチャンクに配布できないため、ユーティリティはそのかわりにパラレル接続を使用して複数のファイルを一度にアップロードします。 入力データファイルが 1 つしかない場合、圧縮ファイルのアップロードで使用できるのは 1 つの接続のみです。

データスループットの最大制限 (バイト/秒/スレッド)。 クライアントホストまたはターゲットサーバーのネットワーク、I/O または CPU の飽和を回避する必要がある場合は、このオプションを使用します。 最大速度はバイト数で指定することも、接尾辞 k (キロバイト)、M (メガバイト)、G (ギガバイト) を使用して指定することもできます。 たとえば、maxRate="5M"では、各スレッドが 5MB のデータ/秒に制限され、8 つのスレッドで 40MB/秒の転送速度が得られます。 デフォルトは 0 で、これは制限がないことを意味します。

インポートの進行状況情報を表示 (true) または非表示 (false) します。 デフォルトは、stdout が端末 (tty) の場合は true、それ以外の場合は false です。