平行表格匯入工具可以從資料檔案擷取欄位以進行輸入前處理，方式與使用 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 資料。每個方言的套用設定如下

linesTerminatedBy: "characters"

fieldsTerminatedBy: "characters"

fieldsEnclosedBy: "character"

fieldsOptionallyEnclosed: [ true | false ]

fieldsEscapedBy: "character"

characterSet: "charset"

bytesPerChunk: "size"

用於將輸入檔案或多個檔案中的資料傳送到目標伺服器的最大平行執行緒數量。如果未指定執行緒數量，則預設最大值為 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] 設定檔。

連線至 Oracle Cloud Infrastructure 時要使用的驗證方法。此選項需要 osBucketName 配置有效值。

提供以下選項

傾印檔案所在的 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://命名空間.compat.objectstorage.區域.oraclecloud.com。將 命名空間 替換為 Object Storage 命名空間，並將 區域 替換為您的區域識別碼。例如，美國東部 (阿什本) 區域的區域識別碼為 us-ashburn-1。

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

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

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

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

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

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

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