建立 Google Cloud Storage (GCS) 捷徑

在本文章中，您將了解如何在 Fabric 湖存放庫內建立 Google Cloud Storage (GCS) 捷徑。 您可使用 GCS 的 XML API 建立 Google Cloud Storage (GCS) 捷徑。 建立 Google Cloud Storage 捷徑時，目標路徑必須至少包含桶名稱。 您也可以透過進一步指定儲存層次結構中要指向的前綴或資料夾，來限制捷徑的適用範圍。

GCS 捷徑僅供閱讀。 無論使用者的權限如何，它們都不支援寫入作業。

如需捷徑的概觀，請參閱 OneLake 捷徑。 若要以程序設計方式建立捷徑，請參閱 OneLake 捷徑 REST API。

GCS 捷徑可利用檔案快取，降低跨雲資料存取的出口成本。 欲了解更多資訊，請參閱 OneLake 快取捷徑>。

必要條件

• 如果你還沒有湖邊別墅，請按照以下步驟建立： 建立湖邊別墅。

• 確保您選擇的 GCS 桶與使用者符合 GCS 捷徑的 存取 與 授權 要求。

建立捷徑

1. 開一間湖邊別墅。

2. 在湖 景 中右鍵點擊湖屋目錄。

3. 選取 [新增捷徑]。

   

選取來源

1. 在 [外部來源] 底下，選取 [Google Cloud Storage]。

   

2. 根據下表輸入 [連線設定]：

   

   Field	描述	Value
   URL	你的 GCS 儲存桶的連接字串。 桶名稱為可選的。	https:// 桶名.storage.googleapis.comhttps://storage.googleapis.com
   [連接]	先前為指定儲存位置定義的連線會出現在下拉式清單中。 如果沒有連線，請建立新的連線。	建立新連線
   連線名稱	使用者為連線定義名稱。	你的連線名稱。
   驗證種類	Fabric 會使用雜湊式訊息驗證碼 (HMAC) 金鑰來存取 Google Cloud Storage。 這些金鑰會與使用者或服務帳戶相關聯。 帳戶必須具有存取 GCS 貯體內資料的權限。 如果在連線 URL 中使用貯體特定端點，帳戶必須具有 storage.objects.get 和 storage.objects.list 權限。 如果在連線 URL 中使用全域端點，帳戶必須具有 storage.buckets.list 權限。	HMAC 金鑰
   存取 ID	與使用者或服務帳戶相關聯的存取金鑰。 如需建立 HMAC 金鑰的詳細資訊，請參閱 管理 HMAC 金鑰。	您的存取金鑰。
   祕密	存取金鑰的祕密。	您的祕密金鑰。

3. 選取 [下一步]。

4. 瀏覽至捷徑的目標位置。

   

   如果您在連線 URL 中使用全域端點，則所有可用的儲存桶都會出現在導覽檢視的左側。 如果您在連線 URL 中使用貯體特定端點，則導覽檢視中只會顯示指定的貯體及其內容。

   選取資料夾或按兩下資料夾旁邊的展開箭號，以瀏覽儲存體帳戶。

   在此檢視中，您可以選取一或多個快捷方式目標位置。 按兩下左側導覽檢視中資料夾旁的複選框，選擇目標位置。

5. 選取 [下一步]。

   

   檢閱頁面可讓您確認所有選擇。 您可以在這裡看到將建立的每個快捷方式。 在動作資料行中，您可以按下鉛筆圖示來編輯快捷方式名稱。 您可以按下垃圾桶圖示來刪除快捷方式。

6. 選取 ，創建。

Lakehouse 會自動更新。 捷徑顯示在左側 的 Explorer 窗格。

Access

在設定 GCS 捷徑的連線時，您可指定儲存體服務的全域端點，或使用貯體特定端點。

• 全域端點範例：https://storage.googleapis.com
• 儲存桶特定端點範例：https://<BucketName>.storage.googleapis.com

Authorization

GCS 捷徑使用委派授權模型。 在此模型，捷徑建立者會指定 GCS 捷徑憑證，且該捷徑的所有存取權均由該憑證授權。 支援的委派憑證是服務帳戶或使用者帳戶的 HMAC 金鑰與密碼。

帳戶必須具有存取 GCS 貯體內資料的權限。 若捷徑連線使用了儲存桶特定端點，則帳戶所需的權限如下：

• storage.objects.get
• storage.objects.list

若在捷徑連線使用全域端點，則帳戶也必須擁有下列權限：

• storage.buckets.list

局限性

Google Cloud Storage 捷徑適用以下限制：

• GCS 捷徑僅供閱讀。 無論使用者的權限如何，它們都不支援寫入作業。

相關內容

• 建立 OneLake 快捷方式
• 建立 Azure Data Lake Storage Gen2 捷徑
• 使用 OneLake 快速存取 REST API