平行表格匯入公用程式可以與 LOAD DATA 陳述式相同的方式，從資料檔案中擷取欄，以進行輸入前處理。您可以捨棄選取的資料，或者您可以轉換資料並將其指派給目標表格中的欄。

資料必須從用戶端主機可以存取為本機磁碟的位置匯入，或者資料可以從 Oracle Cloud Infrastructure 物件儲存體儲存桶匯入，並以 osBucketName 選項指定。

平行表格匯入公用程式可以將單一輸入資料檔案匯入單一關聯式表格，並且也可以匯入指定的檔案清單，並支援萬用字元模式比對，以包含位置中的所有相關檔案。單次執行公用程式上傳的多個檔案會放置到單一關聯式表格中，因此，例如，可以將從多個主機匯出的資料合併到單一表格中以用於分析。

平行表格匯入公用程式可以接受未壓縮的輸入資料檔案。此公用程式會分析資料檔案、將其分散成區塊，並將這些區塊上傳到目標 MySQL 伺服器中的關聯式表格，並在平行連線之間分割區塊。此公用程式也可以接受以 gzip (.gz) 和 zstd (.zst) 格式壓縮的資料檔案，並根據檔案副檔名自動偵測格式。此公用程式會以壓縮格式從儲存體上傳壓縮檔案，以節省傳輸部分的頻寬。壓縮檔案無法分散成區塊，因此公用程式會改為使用平行連線，同時將多個檔案解壓縮並上傳到目標伺服器。如果只有一個輸入資料檔案，則壓縮檔案的上傳只能使用單一連線。

連線的 MySQL 伺服器上的目標資料庫名稱。如果您省略此選項，公用程式會嘗試識別並使用目前 MySQL Shell 工作階段所用的結構描述名稱，如連線 URI 字串、\use 命令或 MySQL Shell 選項中所指定。如果未指定結構描述名稱，且無法從工作階段識別，則會傳回錯誤。

目標關聯式資料表的名稱。如果您省略此選項，公用程式會假設資料表名稱為資料檔案的名稱，但不含副檔名。目標資料表必須存在於目標資料庫中。

包含來自匯入檔案的資料行名稱的字串陣列，依它們對應至目標關聯式資料表中的資料行的順序指定。如果匯入的資料不包含目標資料表的所有資料行，或如果匯入資料中的欄位順序與資料表中的資料行順序不同，請使用此選項。如果您省略此選項，則輸入行應包含目標資料表中每個資料行的相符欄位。

您可以將此選項用於擷取匯入檔案中的資料行，以便進行輸入預處理，如同使用 LOAD DATA 陳述式一樣。當您在陣列中使用整數值來取代資料行名稱時，匯入檔案中的該資料行會擷取為使用者變數 @int，例如 @1。您可以捨棄選取的資料，也可以使用 decodeColumns 選項來轉換資料並將其指派給目標資料表中的資料行。

在此 MySQL Shell JavaScript 模式的範例中，匯入檔案的第二個和第四個資料行會指派給使用者變數 @1 和 @2，且沒有 decodeColumns 選項可將它們指派給目標資料表中的任何資料行，因此它們會被捨棄。

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

鍵值配對的字典，將 columns 選項擷取為使用者變數的匯入檔案資料行指派給目標資料表中的資料行，並指定它們的預處理轉換，如同 LOAD DATA 陳述式的 SET 子句一樣。

在此 MySQL Shell JavaScript 模式的範例中，來自資料檔案的第一個輸入資料行會用作目標資料表中的第一個資料行。在將第二個輸入資料行 (已由 columns 選項指派給變數 @1) 用作目標資料表中的第二個資料行的值之前，會對其執行除法運算。

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

在此 MySQL Shell JavaScript 模式的範例中，來自資料檔案的輸入資料行都會指派給變數，然後以各種方式轉換並用於填入目標資料表的資料行

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 資料。每個方言的套用設定如下

終止輸入資料檔案中每行的字元 (一或多個字元或空字串)。預設值與指定的方言相同，如果省略方言選項，則為換行字元 (\n)。此選項相當於 LOAD DATA 陳述式的 LINES TERMINATED BY 選項。請注意，公用程式不會為 LOAD DATA 陳述式的 LINES STARTING BY 選項提供對等項目，該選項會設定為空字串。

一個或多個字元（或空字串），用於終止輸入資料檔案中的每個欄位。預設值與指定的方言相同，如果省略方言選項，則預設值為 Tab 字元（\t）。此選項等同於 LOAD DATA 陳述式的 FIELDS TERMINATED BY 選項。

一個單一字元（或空字串），用於包圍輸入資料檔案中的每個欄位。預設值與指定的方言相同，如果省略方言選項，則預設值為空字串。此選項等同於 LOAD DATA 陳述式的 FIELDS ENCLOSED BY 選項。

指定給 fieldsEnclosedBy 的字元是否包圍輸入資料檔案中的所有欄位 (false)，或者僅在某些情況下包圍欄位 (true)。預設值與指定的方言相同，如果省略方言選項，則預設值為 false。此選項使 fieldsEnclosedBy 選項等同於 LOAD DATA 陳述式的 FIELDS OPTIONALLY ENCLOSED BY 選項。

輸入資料檔案中用於開始逸出序列的字元。如果未提供此選項，則不會進行逸出序列的解釋。預設值與指定的方言相同，如果省略方言選項，則預設值為反斜線 (\)。此選項等同於 LOAD DATA 陳述式的 FIELDS ESCAPED BY 選項。

此選項指定在匯入期間用於解譯輸入資料的字元集編碼。將此選項設定為 binary 表示匯入期間不進行任何轉換。當您省略此選項時，匯入會使用 character_set_database 系統變數指定的字元集來解譯輸入資料。

對於多個輸入資料檔案的清單，此選項不可用。對於單一輸入資料檔案，此選項指定執行每個 LOAD DATA 呼叫時，執行緒傳送給目標伺服器的位元組數（加上達到列尾所需的任何額外位元組）。此公用程式會將資料分配成此大小的區塊，供執行緒擷取並傳送至目標伺服器。區塊大小可以指定為位元組數，或使用後綴 k（千位元組）、M（百萬位元組）、G（十億位元組）。例如，bytesPerChunk="2k" 會使執行緒傳送大約 2 千位元組的區塊。最小區塊大小為 131072 位元組，預設區塊大小為 50M。

用於將輸入檔案中的資料傳送至目標伺服器的最大平行執行緒數。如果您未指定執行緒數，則預設最大值為 8。對於多個輸入資料檔案的清單，此公用程式會建立指定或最大數量的執行緒。對於單一輸入資料檔案，此公用程式會使用以下公式計算要建立的適當執行緒數（直到此最大值）

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

其中 threads 是最大執行緒數，而 chunks 是資料將分割成的區塊數，其計算方式為將檔案大小除以 bytesPerChunk 大小，然後加 1。此計算可確保如果最大執行緒數超過實際要傳送的區塊數，則此公用程式不會建立超出必要的執行緒數。

壓縮檔案無法分配到區塊中，因此此公用程式會改用其平行連線一次上傳多個檔案。如果只有一個輸入資料檔案，則壓縮檔案的上傳只能使用單一連線。

每個執行緒每秒的資料輸送量最大限制（以位元組為單位）。如果需要避免客戶端主機或目標伺服器的網路、I/O 或 CPU 飽和，請使用此選項。最大速率可以指定為位元組數，或使用後綴 k（千位元組）、M（百萬位元組）、G（十億位元組）。例如，maxRate="5M" 將每個執行緒限制為每秒 5MB 的資料，對於八個執行緒，傳輸速率為 40MB/秒。預設值為 0，表示沒有限制。

顯示 (true) 或隱藏 (false) 匯入的進度資訊。如果 stdout 是終端機 (tty)，則預設值為 true，否則為 false。

在用於將資料載入目標 MySQL 實例的每個客戶端會話開始時要執行的 SQL 陳述式清單。您可以使用此選項來變更會話變數。例如，以下陳述式會針對公用程式在匯入期間使用的會話，略過目標 MySQL 實例上的二進位記錄，並增加可用於建立索引的執行緒數

sessionInitSQL: ["SET SESSION sql_log_bin=0;", "SET SESSION innodb_ddl_threads=8,"]

如果在執行 SQL 陳述式時發生錯誤，則匯入會停止並傳回錯誤訊息。

輸入資料檔案所在的 Oracle Cloud Infrastructure Object Storage 儲存貯體的名稱。依預設，位於 ~/.oci/config 的 Oracle Cloud Infrastructure CLI 設定檔中的 [DEFAULT] 設定檔，會用於建立與儲存貯體的連線。您可以使用 ociConfigFile 和 ociProfile 選項，來替換要用於連線的替代設定檔。如需設定 CLI 設定檔的指示，請參閱 SDK 和 CLI 設定檔。

名為 osBucketName 的 Object Storage 儲存貯體所在的 Oracle Cloud Infrastructure 命名空間。Object Storage 儲存貯體的命名空間會顯示在 Oracle Cloud Infrastructure 主控台中儲存貯體詳細資料頁面的「儲存貯體資訊」索引標籤中，或可以使用 Oracle Cloud Infrastructure 命令列介面取得。

包含要用於連線的設定檔的 Oracle Cloud Infrastructure CLI 設定檔，而不是預設位置 ~/.oci/config 中的設定檔。

要用於連線的 Oracle Cloud Infrastructure 設定檔的設定檔名稱，而不是用於連線的 Oracle Cloud Infrastructure CLI 設定檔中的 [DEFAULT] 設定檔。

傾印檔案所在的 S3 儲存貯體的名稱。依預設，位於 ~/.aws/ 的 Amazon Web Services (AWS) CLI config 和 credentials 檔案中的 default 設定檔，會用於建立與 S3 儲存貯體的連線。您可以使用 s3ConfigFile 和 s3CredentialsFile 選項，來替換連線的替代設定和認證。如需安裝和設定 AWS CLI 的指示，請參閱 AWS CLI 入門。

包含使用者認證的認證檔，用於連線，而不是預設位置 ~/.aws/credentials 中的認證檔。一般而言，認證檔包含用於連線的 aws_access_key_id 和 aws_secret_access_key。

包含要用於連線的設定檔的 AWS CLI 設定檔，而不是預設位置 ~/.aws/config 中的設定檔。一般而言，設定檔包含用於連線的區域和輸出類型。

要用於連線的 S3 CLI 設定檔的設定檔名稱，而不是用於連線的 AWS CLI 設定檔中的 default 設定檔。

要用於連線的區域名稱。

要使用的端點 URL，而不是預設值。

當連線到 Oracle Cloud Infrastructure S3 相容性 API 時，端點採用以下格式：https://namespace.compat.objectstorage.region.oraclecloud.com。將 namespace 替換為 Object Storage 命名空間，並將 region 替換為您的區域識別碼。例如，美國東部（阿什本）區域的區域識別碼為 us-ashburn-1。

對於美國東部（阿什本）區域中名為 axaxnpcrorw5 的命名空間

https://axaxnpcrorw5.compat.objectstorage.us-ashburn-1.oraclecloud.com.

必要。要從中匯入表格的 Azure 容器名稱。容器必須存在。

選用。包含儲存體連線參數的設定檔，而不是預設位置（例如 ~/.azure/config）中的設定檔。如果未定義此選項，則會使用預設設定檔。

必須定義 azureContainerName，且不得為空。

選用。用於作業的 Azure 儲存體帳戶名稱。

選用。用於作業驗證的 Azure 共用存取簽章 (SAS) 權杖，而不是金鑰。