在複製活動中設定 Azure 表格儲存體

本文概述如何在資料管線中使用複製活動，從 Azure 表格儲存體複製資料以及將資料複製到其中。

支援的設定

對於複製活動下每個索引標籤的組態，請分別參閱下列各節。

• 一般
• 來源
• 目的地
• 對應
• 設定

一般

請參閱＜[一般] 設定＞指導，來設定 [一般] 設定索引標籤。

來源

前往 [來源] 索引標籤以設定複製活動來源。 如需詳細的組態，請參閱下列內容。

以下是三個必要的屬性：

• 資料存放區類型：選取 [外部]。

• 連線：從連線清單中選取 Azure 表格儲存體連線。 如果不存在連線，請選取 [新增]，來建立新的 Azure 表格儲存體連線。

• 使用查詢：指定讀取資料的方式。 選取 [資料表] 以從指定的資料表讀取資料，或選取 [查詢] 以使用查詢讀取資料。

  如果選取 [資料表]：

  

  • 資料表：指定 Azure 表格儲存體資料庫執行個體中的資料表名稱。 從下拉式清單中選取資料表，或選取 [編輯] 以手動輸入。

  如果選取 [查詢]：

  

  • 資料表：指定 Azure 表格儲存體資料庫執行個體中的資料表名稱。 從下拉式清單中選取資料表，或選取 [編輯] 以手動輸入。

  • 查詢：指定自訂表格儲存體查詢來讀取資料。 來源查詢是從 Azure 表格儲存體支援的 $filter 查詢選項直接對應，若要了解有關語法的詳細資料，請參閱本文。

    注意

    Azure 資料表查詢作業會在 30 秒後依 Azure 資料表服務強制 (機器翻譯) 逾時。 若要了解如何將查詢最佳化，請參閱設計查詢一文。

在 [進階] 下，可以指定下列欄位：

• 略過找不到資料表：指定是否允許資料表不存在的例外狀況。 預設情況下，不會選取此選項。

• 其他資料行：新增其他資料行來儲存來源檔案的相對路徑或靜態值。 後者支援運算式。

Destination

前往 [目的地] 索引標籤以設定複製活動目的地。 如需詳細的組態，請參閱下列內容。

以下是三個必要的屬性：

• 資料存放區類型：選取 [外部]。
• 連線：從連線清單中選取 Azure 表格儲存體連線。 如果不存在連線，請選取 [新增]，來建立新的 Azure 表格儲存體連線。
• 資料表：指定 Azure 表格儲存體資料庫執行個體中的資料表名稱。 從下拉式清單中選取資料表，或選取 [編輯] 以手動輸入。

在 [進階] 下，可以指定下列欄位：

• 插入類型：選取將資料插入 Azure 資料表的模式。 模式為 [合併] 和 [取代]。 此屬性可控制針對輸出資料表中具有相符分割區和資料列索引鍵的現有資料列，是要取代還是合併其值。 這個設定會在資料列層級套用，而不是在資料表層級套用。 這兩個選項都不會刪除不存在於輸入中的輸出資料表資料列。 若要了解合併和取代設定的運作方式，請參閱插入或合併實體和插入或取代實體。

• 分割區索引鍵值選取：從 [指定分割區值] 或 [使用目的地資料行] 中選取。 分割區索引鍵值可以是固定值，也可以從目的地資料行取值。

  如果選擇 [指定分割區值]：

  • 預設分割區值：指定目的地可使用的預設分割區索引鍵值。

  如果選擇 [使用目的地資料行]：

  • 分割區索引鍵資料行：選取要將其值作為分割區索引鍵的資料行名稱。 如果未指定，則會使用 "AzureTableDefaultPartitionKeyValue" 作為分割區索引鍵。

• 資料列索引鍵值選取：從 [唯一識別碼] 或 [使用目的地資料行] 中選取選取。 資料列索引鍵值可以是自動產生的唯一識別碼，也可以從目的地資料行取值。

  如果選擇 [使用目的地資料行]：

  • 資料列索引鍵資料行：選取要將其值作為資料列索引鍵的資料行名稱。 如果未指定，則會針對每個資料列使用 GUID。

• 寫入批次大小：達到指定的寫入批次大小時，將資料插入 Azure 資料表。 允許的值為整數 (資料列數目)。 預設值為 10,000。

• 寫入批次逾時：達到指定的寫入批次逾時時，將資料插入 Azure 資料表。 允許的值為時間範圍。

• 並行連線數上限：在活動執行期間，與資料存放區建立的並行連線數上限。 僅在想要限制並行連線時，才需要指定值。

對應

對於 [對應] 索引標籤組態，請參閱＜在 [對應] 索引標籤下設定對應＞。

設定

對於 [設定] 索引標籤組態，請參閱＜在 [設定] 索引標籤下進行其他設定＞。

資料表摘要

下列資料表包含有關 Azure 表格儲存體中複製活動的詳細資訊。

來源資訊

名稱	描述:	值	必要	JSON 指令碼屬性
資料存放區類型	資料存放區類型。	外部	必要	/
[連接]	與來源資料存放區的連線。	<您的 Azure 表格儲存體連線>	必要	connection
使用查詢	讀取資料的方式。 套用 [資料表] 以從指定的資料表讀取資料，或套用 [查詢] 以使用查詢讀取資料。	• 資料表 • 查詢	必要	/
Table	Azure 表格儲存體資料庫執行個體中的資料表名稱。	<您的資料表名稱>	必要	tableName
查詢	指定自訂表格儲存體查詢來讀取資料。 來源查詢是從 Azure 表格儲存體支援的 $filter 查詢選項直接對應，若要了解有關語法的詳細資料，請參閱本文。	<您的查詢>	不必要	AzureTableSourceQuery
略過找不到資料表	指出是否讓資料表例外狀況不存在。	已選取或未選取 (預設值)	不必要	azureTableSourceIgnoreTableNotFound： true 或 false (預設值)
其他資料行	新增其他資料行來儲存來源檔案的相對路徑或靜態值。 後者支援運算式。	• 名稱 • 值	不必要	additionalColumns： • 名稱 • 值

目的地資訊

名稱	描述:	值	必要	JSON 指令碼屬性
資料存放區類型	資料存放區類型。	外部	必要	/
[連接]	與目的地資料存放區的連線。	<您的 Azure 表格儲存體連線>	必要	connection
Table	Azure 表格儲存體資料庫執行個體中的資料表名稱。	<您的資料表名稱>	必要	tableName
插入類型	將資料插入 Azure 資料表的模式。 此屬性可控制針對輸出資料表中具有相符分割區和資料列索引鍵的現有資料列，是要取代還是合併其值。	• 合併 • 取代	不必要	azureTableInsertType： • 合併 • 取代
分割區索引鍵值選取	分割區索引鍵值可以是固定值，也可以從目的地資料行取值。	• 指定分割區值 • 使用目的地資料行	不必要	/
預設分割區值	可供目的地使用的預設資料分割區索引鍵值。	<預設分割區值>	不必要	azureTableDefaultPartitionKeyValue
分割區索引鍵資料行	要將其值用來作為分割區索引鍵的資料行名稱。 如果未指定，則會使用 "AzureTableDefaultPartitionKeyValue" 作為分割區索引鍵。	<您的分割區索引鍵資料行>	不必要	azureTablePartitionKeyName
資料列索引鍵值選取	資料列索引鍵值可以是自動產生的唯一識別碼，也可以從目的地資料行取值。	• 唯一識別碼 • 使用目的地資料行	不必要	/
資料列索引鍵資料行	要將其值作為資料列索引鍵的資料行名稱。 如果未指定，則會針對每個資料列使用 GUID。	<您的資料列索引鍵資料行>	不必要	azureTableRowKeyName
寫入批次大小	達到寫入批次大小時，將資料插入 Azure 資料表。	integer (預設值為 10,000)	不必要	writeBatchSize
寫入批次逾時	達到寫入批次逾時時，將資料插入 Azure 資料表	時間範圍	不必要	writeBatchTimeout
並行連線數上限	在活動執行期間建立至資料存放區的同時連線上限。 僅在想要限制並行連線時，才需要指定值。	<並行連線數上限>	不必要	maxConcurrentConnections

相關內容

• Azure 表格儲存體連接器概觀