適用於：
Azure Data Factory Azure Synapse Analytics
提示
Data Factory in Microsoft Fabric 是下一代的 Azure Data Factory，擁有更簡單的架構、內建 AI 及新功能。 如果你是資料整合新手，建議先從 Fabric Data Factory 開始。 現有的 ADF 工作負載可升級至 Fabric，以存取資料科學、即時分析與報告等新能力。
本文說明如何使用 Data Flow 在 Google 試算表中轉換資料（預覽）。 欲了解更多，請閱讀Azure Data Factory或Azure Synapse Analytics的介紹文章。
Note
此連接器也可在 Microsoft Fabric 的 Data Factory 中取得。 關於 Fabric 專屬的設定與功能，請參閱 Fabric Google 試算表連接器文件。
重要
此連接器目前為預覽版。 您可以親身體驗並提供意見反應。 如果你想在解決方案中依賴預覽連接器，請聯絡 Azure 支援。
支援的功能
此 Google 試算表連接器支援下列功能：
| 支援的功能 | IR |
|---|---|
| 映射資料流程 (來源/-) | ① |
（1） Azure 整合執行時 （2） 自架整合執行時
如需支援做為來源/接收器的資料存放區清單，請參閱支援的資料存放區表格。
使用 UI 建立 Google 試算表連結服務
請依照以下步驟在 Azure 入口網站介面中建立 Google 試算表連結服務。
請瀏覽 Azure Data Factory 或 Synapse 工作區的「管理」標籤，選擇「連結服務」，然後選擇「新建服務」：
顯示 Azure Data Factory UI 截圖，建立新連結服務 搜尋 Google 試算表 (預覽)，然後選取 Google 試算表 (預覽) 連接器。
設定服務詳細資料，測試連線，然後建立新的連結服務。
連接器設定詳細資料
下列各節提供有關用來定義 Data Factory 和 Synapse 管線實體中 Google Sheets 特定屬性的資訊。
連結服務屬性
以下是 Google 試算表連結服務所支援的屬性：
| 屬性 | 描述 | 必要 |
|---|---|---|
| 型別 | 類型屬性必須設定為 GoogleSheets。 | Yes |
| apiToken | 指定 Google 試算表的 API 令牌。 將此欄位標記為 SecureString 以將其安全地儲存。 或者，你可以引用儲存在 Azure Key Vault 中的秘密。 | Yes |
範例：
{
"name": "GoogleSheetsLinkedService",
"properties": {
"type": "GoogleSheets",
"typeProperties": {
"apiToken": {
"type": "SecureString",
"value": "<API token>"
}
}
}
}
映射資料流屬性
在進行資料流映射以轉換資料時，您可以從 Google 試算表讀取資源。 如需詳細資訊，請參閱對應資料流程中的來源轉換。 您只能使用內置資料集作為來源類型。
來源轉換
下表列出 Google 試算表來源所支援的屬性。 您可以在 [來源選項] 索引標籤中編輯這些屬性。
| 名稱 | 描述 | 必要 | 允許的值 | 資料流程指令碼屬性 |
|---|---|---|---|---|
| 試算表識別碼 | Google 試算表中的識別碼。 請確定試算表的一般存取權設定為 [具有連結的任何人]。 | Yes | 字符串 | spreadSheetId（試算表識別碼） |
| 工作表名稱 | 試算表中的工作表名稱。 | Yes | 字符串 | sheetName |
| 開始儲存格 | 工作表中需要資料的起始儲存格，例如 A2、B4。 | Yes | 字符串 | startCell |
| 結束儲存格 | 工作表中需要資料的結束儲存格，例如 F10、S600。 | Yes | 字符串 | endCell |
Google 試算表來源指令碼範例
當您使用 Google 試算表作為來源類型時，相關聯的資料流程指令碼為：
source(allowSchemaDrift: true,
validateSchema: false,
store: 'googlesheets',
format: 'rest',
spreadSheetId: $spreadSheetId,
startCell: 'A2',
endCell: 'F10',
sheetName: 'Sheet1') ~> GoogleSheetsSource
相關內容
如需複製活動支援作為來源和接收器的資料存放區清單，請參閱支援的資料存放區。