Erstellen einer Google Cloud-Speicher (GCS)-Verknüpfung

In diesem Artikel erfahren Sie, wie Sie eine Google Cloud Storage (GCS)-Verknüpfung in einem Fabric Lakehouse erstellen. Verknüpfungen zu Google Cloud Storage (GCS) können mithilfe der XML-API für GCS erstellt werden. Wenn Sie Verknüpfungen zu Google Cloud Storage erstellen, muss der Zielpfad mindestens einen Bucket-Namen enthalten. Sie können auch den Anwendungsbereich der Verknüpfung einschränken, indem Sie das Präfix oder den Ordner genauer angeben, auf den Sie innerhalb der Speicherhierarchie verweisen möchten.

GCS-Verknüpfungen sind schreibgeschützt. Sie unterstützen Schreibvorgänge unabhängig von den Berechtigungen des Benutzers nicht.

Eine Übersicht über Verknüpfungen finden Sie unter OneLake-Verknüpfungen. Informationen zum programmgesteuerten Erstellen von Verknüpfungen finden Sie unter OneLake-Verknüpfungen mit REST-APIs.

GCS-Verknüpfungen können die Vorteile der Dateizwischenspeicherung nutzen, um die Egress-Kosten für den cloudübergreifenden Datenzugriff zu senken. Weitere Informationen finden Sie unter OneLake-Verknüpfungen> Zwischenspeichern.

Voraussetzungen

• Wenn Sie kein Lakehouse haben, erstellen Sie eins mit den Schritten unter Erstellen eines Lakehouse mit OneLake.

• Stellen Sie sicher, dass der ausgewählte GCS-Bucket und der Benutzer die Zugriffsanforderungen und Autorisierungsanforderungen für GCS-Kurzbefehle erfüllen.

Erstellen einer Verknüpfung

1. Öffnen Sie ein Lakehouse.

2. Klicken Sie mit der rechten Maustaste auf ein Verzeichnis in der Lake-Ansicht des Lakehouse.

3. Wählen Sie Neue Verknüpfung aus.

   

Auswählen einer Quelle

1. Wählen Sie unter Externe QuellenGoogle Cloud-Speicher aus.

   

2. Geben Sie die Verbindungseinstellungen gemäß der folgenden Tabelle ein:

   

   Feld	Beschreibung	Wert
   URL	Die Verbindungszeichenfolge für Ihren GCS-Bucket. Der Bucketname ist optional.	https:// BucketName.storage.googleapis.comhttps://storage.googleapis.com
   Verbindung	Zuvor definierte Verbindungen für den angegebenen Speicherort werden in der Dropdownliste angezeigt. Wenn keine Verbindungen vorhanden sind, erstellen Sie eine neue Verbindung.	Neue Verbindung erstellen
   Verbindungsname	Der benutzerdefinierte Name der Verbindung.	Ein Name für Ihre Verbindung.
   Authentifizierungsart	Fabric verwendet hashbasierte Nachrichten-Authentifizierungscodes (HMAC), um auf den Google-Cloud-Speicher zuzugreifen. Diese Schlüssel sind einem Benutzer- oder Dienstkonto zugeordnet. Das Konto muss über die Berechtigung zum Zugriff auf die Daten im GCS-Bucket verfügen. Wenn der bucket-spezifische Endpunkt in der Verbindungs-URL verwendet wurde, muss das Konto über die storage.objects.get- und storage.objects.list-Berechtigungen verfügen. Wenn der globale Endpunkt in der Verbindungs-URL verwendet wurde, muss das Konto auch die storage.buckets.list-Berechtigung haben.	HMAC-Schlüssel
   Zugriffs-ID	Der Zugriffsschlüssel, der einem Benutzer- oder Dienstkonto zugeordnet ist. Weitere Informationen zum Erstellen von HMAC-Schlüsseln finden Sie unter Verwalten von HMAC-Schlüsseln.	Ihr Zugriffsschlüssel
   Geheimnis	Das Geheimnis für den Zugriffsschlüssel.	Ihren geheimen Schlüssel.

3. Wählen Sie Weiter aus.

4. Navigieren Sie zum Zielspeicherort der Verknüpfung.

   

   Wenn Sie den globalen Endpunkt in der Verbindungs-URL verwendet haben, werden alle verfügbaren Buckets in der linken Navigationsansicht angezeigt. Wenn Sie einen bucketspezifischen Endpunkt in der Verbindungs-URL verwendet haben, werden nur der angegebene Bucket und dessen Inhalt in der Navigationsansicht angezeigt.

   Navigieren Sie zum Speicherkonto, indem Sie einen Ordner auswählen oder auf den Erweiterungspfeil neben einem Ordner klicken.

   In dieser Ansicht können Sie einen oder mehrere Zielspeicherorte für Verknüpfungen auswählen. Wählen Sie Zielspeicherorte aus, indem Sie in der linken Navigationsansicht auf das Kontrollkästchen neben einem Ordner klicken.

5. Wählen Sie Weiter aus.

   

   Auf der Überprüfungsseite können Sie alle Ihre Auswahloptionen verifizieren. Dort werden alle Verknüpfungen angezeigt, die erstellt werden. In der Aktionsspalte können Sie auf das Bleistiftsymbol klicken, um den Verknüpfungsnamen zu bearbeiten. Per Klick auf das Papierkorbsymbol können Sie eine Verknüpfung löschen.

6. Klicken Sie auf Erstellen.

Das Lakehouse wird automatisch aktualisiert. Die Verknüpfung wird im linken Explorer-Bereich angezeigt.

Zugang

Beim Konfigurieren der Verbindung für eine GCS-Verknüpfung können Sie entweder den globalen Endpunkt für den Speicherdienst angeben oder einen bucketspezifischen Endpunkt verwenden.

• Beispiel für globalen Endpunkt: https://storage.googleapis.com
• Beispiel für bucketspezifischen Endpunkt: https://<BucketName>.storage.googleapis.com

Autorisierung

GCS-Shortcuts verwenden ein delegiertes Autorisierungsmodell. In diesem Modell gibt der Ersteller der Verknüpfung Anmeldeinformationen für die GCS-Verknüpfung an, und der gesamte Zugriff auf diese Verknüpfung wird mit diesen Anmeldeinformationen autorisiert. Die unterstützten delegierten Anmeldedaten sind ein HMAC-Schlüssel und geheimer Schlüssel für ein Dienstkonto oder Benutzerkonto.

Das Konto muss über die Berechtigung zum Zugriff auf die Daten im GCS-Bucket verfügen. Wenn der bucketspezifische Endpunkt in der Verbindung für die Verknüpfung verwendet wurde, muss das Konto über die folgenden Berechtigungen verfügen:

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

Wenn der globale Endpunkt in der Verbindung für die Verknüpfung verwendet wurde, muss das Konto auch über die folgende Berechtigung verfügen:

• storage.buckets.list

Einschränkungen

Die folgenden Einschränkungen gelten für Google Cloud Storage-Verknüpfungen:

• GCS-Verknüpfungen sind schreibgeschützt. Sie unterstützen Schreibvorgänge unabhängig von den Berechtigungen des Benutzers nicht.

Zugehöriger Inhalt

• Erstellen einer OneLake-Verknüpfung
• Erstellen einer Azure Data Lake Storage Gen2-Verknüpfung
• Verwenden Sie die OneLake-Shortcuts-REST-APIs