Snowflake Connector for SharePoint einrichten¶
Bemerkung
Der Snowflake Connector for SharePoint unterliegt den `Nutzungsbedingungen für Konnektoren<https://www.snowflake.com/legal/snowflake-connector-terms/>`_.
Wichtig
Vielen Dank für Ihr Interesse an Snowflake Connector für SharePoint. Wir konzentrieren uns momentan auf eine Lösung der nächsten Generation, die ein deutlich verbessertes Benutzererlebnis bieten wird. Daher ist die Veröffentlichung dieses Konnektors mit dem Status „Allgemeine Verfügbarkeit“ derzeit nicht teil unserer Produkt-Roadmap. Sie können diesen Konnektor weiterhin als Vorschau-Feature verwenden. Beachten Sie aber, dass die Unterstützung von zukünftigen Fehlerkorrekturen und Verbesserungen nicht garantiert ist. Die neue Lösung ist als Openflow-Konnektor für SharePoint verfügbar und umfasst bessere Performance, Anpassbarkeit und erweiterte Bereitstellungsoptionen.
Unter diesem Thema werden die Schritte zur Einrichtung von Snowflake Connector for SharePoint.
Voraussetzungen¶
Bevor Sie mit der Installation und Konfiguration des Konnektors beginnen, müssen Sie Folgendes tun:
Stellen Sie sicher, dass Sie eine `Microsoft Graph<https://learn.microsoft.com/en-us/graph/overview>`_-Anwendung mit den folgenden Berechtigungen haben:
Sites.Selected: schränkt den Zugriff nur auf bestimmte Websites ein.
Files.SelectedOperations.Selected: schränkt den Zugriff nur auf Dateien in angegebenen Websites ein.
GroupMember. Read.All: wird für die Auflösung von SharePoint-Gruppenberechtigungen verwendet.
Konfigurieren Sie SharePoint zum Aktivieren der OAuth-Authentifizierung, wie unter`Zugriff ohne Benutzer erhalten <https://learn.microsoft.com/en-us/graph/auth-v2-service?tabs=http#authentication-and-authorization-steps>`_ beschrieben. Der Konnektor verwendet die folgenden Microsoft Graph-APIs zum Abrufen von Daten von SharePoint:
Rufen Sie die Website-URL Ihrer Microsoft 365 SharePoint-Website mit den Dateien oder Ordnern auf, die Sie in Snowflake aufnehmen möchten, sowie die Anmeldedaten von Ihrem Azure- oder Office 365-Kontoadministrator.
Snowflake Connector for SharePoint installieren¶
Konnektoren sind Instanzen von nativen Snowflake-Anwendungen. Gehen Sie zum Installieren von Snowflake Connector for SharePoint wie folgt vor:
Melden Sie sich bei Snowflake als Benutzer mit der Rolle ACCOUNTADMIN an.
Navigieren Sie zu Data Products » Marketplace.
Suchen Sie nach Snowflake Connector for SharePoint und wählen Sie Get aus.
Erweitern Sie im Dialogfeld die Option Options und geben Sie die folgenden Informationen ein:
Geben Sie unter Application name einen Namen für Ihre Konnektoranwendung ein.
Wählen Sie unter Warehouse used for installation das Warehouse aus, das Sie für die Installation des Konnektors verwenden möchten.
Bemerkung
Dies ist nicht dasselbe Warehouse, das vom Konnektor zum Synchronisieren der Daten aus SharePoint verwendet wird. In einem späteren Schritt werden Sie für diesen Zweck ein eigenes Warehouse erstellen.
Wählen Sie Get aus, um den Installationsvorgang zu beginnen. Dies kann einige Minuten dauern.
Nachdem der Konnektor erfolgreich installiert wurde, wählen Sie entweder Configure aus, um mit der -Konfiguration <label-configure_sharepoint_connector>`fortzufahren, oder Sie wählen :ui:`Done aus, um das Dialogfeld zu schließen und die Installation abzuschließen.
Optional: Mehrere Instanzen von Snowflake Connector for SharePoint installieren¶
Sie können mehrere Instanzen von Snowflake Connector for SharePoint auf Ihrem Snowflake-Konto installieren. Um eine zusätzliche Instanz zu installieren, gehen Sie wie folgt vor:
Navigieren Sie zum Snowflake Marketplace, und wählen Sie Snowflake Connector for SharePoint aus. Die Seite mit den Anwendungsdetails wird angezeigt.
Klicken Sie auf Add instance. Der Installationsdialog wird angezeigt.
Geben Sie den Namen der Instanz an, und wählen Sie das Warehouse, das bei der Installation verwendet werden soll.
Wählen Sie Get aus, um den Installationsvorgang zu beginnen.
Bemerkung
Das Hinzufügen von Instanzen des Konnektors kann einige Minuten dauern. Wenn der Installationsvorgang abgeschlossen ist, erhalten Sie eine Benachrichtigung per E-Mail.
Um eine Beschädigung der eingelesenen Daten zu vermeiden, verwenden Sie bei der Konfiguration des Konnektors immer ein Datenbank-Schema, das sich von allen anderen nativen Anwendungen unterscheidet.
Snowflake Connector for SharePoint konfigurieren¶
Jede Konnektoranwendungsinstanz muss so konfiguriert sein, dass sie mit der zugehörigen Sharepoint-Instanz kommunizieren kann. Fahren Sie nach Abschluss des Installationsprozesses mit den folgenden Schritten fort.
Stellen Sie sicher, dass alle Voraussetzungen erfüllt sind. Weitere Informationen dazu finden Sie unter Voraussetzungen.
Öffnen Sie, falls erforderlich, den Konfigurationsassistenten wie folgt:
Melden Sie sich bei Snowsight als Benutzer mit der Rolle ACCOUNTADMIN an.
Wählen Sie im Navigationsmenü die Option Data Products » Apps aus.
Suchen Sie nach Snowflake Connector for SharePoint und wählen Sie es aus.
Konfigurieren¶
Geben Sie im Schritt Configure des Assistenten Informationen in die folgenden Felder ein:
Bemerkung
Standardmäßig werden die Felder auf die Namen der Objekte gesetzt, die bei der Konfiguration des Konnektors erstellt werden. Snowflake empfiehlt die Verwendung neuer Objekte für diese Felder. Sie können bei Bedarf jedoch die Namen vorhandener Objekte angeben (z. B. beim Neuinstallieren des Konnektors).
Feld
Beschreibung
Warehouse for Ingestion Data
Bezeichner für ein neues, dediziertes virtuelles Warehouse für den Konnektor. Dieses Warehouse wird für die Berechnung der Datenaufnahme und der Dokumentenverarbeitungsaufgaben verwendet.
Geben Sie einen Namen an, der für Ihr Konto eindeutig ist. Der Name des Warehouses muss ein gültiger Objektbezeichner sein.
Alternativ können Sie auch ein bestehendes Warehouse auswählen.
Bemerkung
Geben Sie nicht das Warehouse an, das bei der anfänglichen Erstellung des Konnektors verwendet wurde.
Warehouse for Cortex Search:
Bezeichner für ein neues, dediziertes virtuelles Cortex Search Warehouse. Dieses Warehouse wird für die Verarbeitung und Bereitstellung von Cortex Search-Abfragen verwendet.
Geben Sie einen Namen an, der für Ihr Konto eindeutig ist. Der Name des Warehouses muss ein gültiger Objektbezeichner sein.
Bemerkung
Geben Sie nicht das gleiche Warehouse an, das Sie zu Beginn der Installation des Konnektors ausgewählt haben. Der Konfigurationsprozess erstellt ein neues X-Small-Warehouse mit dem angegebenen Namen.
Role for Cortex Search
Bezeichner für eine neue kundenspezifische Rolle für den Konnektor. Geben Sie einen Namen an, der für Ihr Konto eindeutig ist. Der Name der Rolle muss ein gültiger Objektbezeichner sein.
Benutzer, denen die Rolle zugewiesen wurde, können ihr Konto verwenden, um die Cortex REST API über die von der Anwendung aufgenommenen Daten abzufragen. Standardmäßig hat nur das Konto, das Sie zur Installation des Konnektors verwendet haben, die Berechtigung, Abfragen für Cortex durchzuführen.
Klicken Sie auf Configure, um fortzufahren.
Authentifizieren bei und Verbinden mit Sharepoint¶
Wichtig
Stellen Sie sicher, dass Popups in Ihrem Browser aktiviert sind.
Geben Sie im Schritt Authentication des Assistenten die folgenden Informationen und Anmeldeinformationen ein, um die OAuth2-Authentifizierung abzuschließen und eine Verbindung mit SharePoint herzustellen.
Wenden Sie sich an Ihren Azure- oder Office 365-Kontoadministrator, um diese Informationen zu erhalten.
Feld
Beschreibung
SharePoint site URL
URL oder Sharepoint-Site, von der der Konnektor Inhalte aufnehmen wird.
Verwenden Sie für Standorte der obersten Ebene nur den Domänennamen, zum Beispiel
sitename.sharepoint.com
. Verwenden Sie für untergeordnete Sites einen Domänennamen mit dem Pfad der Site, zum Beispielsitename.sharepoint.com/sites/SubSite
.Client ID
Geben Sie Ihre Client-ID ein. Um mehr über die Client-ID zu erfahren und darüber, wie Sie diese in Microsoft Entra finden, siehe Anwendungs-ID (Client-ID).
Client secret
Geben Sie Ihr Client-Geheimnis ein. Weitere Informationen zu Client-Geheimnissen und wie Sie diese in Microsoft Entra finden können, erhalten Sie unter Zertifikate und Geheimnisse.
Tenant ID
Geben Sie Ihre Mandanten-ID ein. Weitere Informationen zur Mandanten-ID und wie Sie diese in Microsoft Entra finden, erhalten Sie unter Suchen Ihrer Microsoft 365-Mandanten-ID.
Klicken Sie auf Next, um den Verbindungsprozess zu starten. Es kann einige Minuten dauern, bis er abgeschlossen ist.
Quelle validieren¶
Gehen Sie im Schritt Validate source des Assistenten wie folgt vor:
Wählen Sie die Quelle aus, aus der Sie die Dateien abrufen möchten:
Wählen Sie All folders aus, wenn Sie Dateien aus allen Ordnern abrufen möchten, auf die Sie über die von Ihnen in Authentifizieren bei und Verbinden mit Sharepoint angegebenen Anmeldeinformationen zugreifen können.
Wählen Sie Specific folder aus, wenn Sie Dateien aus einem bestimmten Ordner abrufen möchten, auf den Sie über die von Ihnen in Authentifizieren bei und Verbinden mit Sharepoint angegebenen Anmeldeinformationen zugreifen können.
Bemerkung
Dieser Pfad ist relativ zum Ordner mit den freigegebenen Dokumenten. Um Dateien aus dem Ordner
Shared%20Documents/user_manuals/cars
zu erfassen, geben Sie zum Beispieluser_manuals/cars
ein.
Bemerkung
Um die Quelle der Abrufdatei zu einem späteren Zeitpunkt zu ändern, müssen Sie den Konnektor neu installieren.
Klicken Sie auf Validate, um den Prozess der Validierung der Quelle zu starten, der einige Minuten dauern kann.
Nachdem Ihr Konnektor erfolgreich konfiguriert wurde, klicken Sie auf Ingest files, um mit der Datenaufnahme zu beginnen.
Nächster Schritt¶
Sobald Ihr Konnektor eingerichtet ist, fahren Sie mit Abfrage des Cortex Search Service mit Snowflake Connector for SharePoint fort.