Perplexity mit Snowflake verbinden

Verbinden Sie ein Snowflake Data Warehouse per User OAuth oder Dienstkonto mit Perplexity – in Pro, Max, Enterprise Pro und Enterprise Max.

Dieser Leitfaden führt Snowflake- und Perplexity-Administratoren durch das Verbinden eines Snowflake Data Warehouse mit Perplexity und zeigt Abonnentinnen und Abonnenten von Pro, Max, Enterprise Pro und Enterprise Max, wie sie sich anmelden.

​

Überblick

Mit dem Snowflake-Konnektor können Sie Daten in Ihrem Snowflake Data Warehouse direkt aus Perplexity abfragen. Sie können Informationen aus Ihren Snowflake-Datenbanken, Ihren anderen verbundenen Apps und dem Web durchsuchen und zusammenführen, ohne SQL von Hand zu schreiben oder zur Snowflake-Konsole zu wechseln.

Snowflake wird pro Benutzer verbunden. Niemand sonst in Ihrer Organisation kann Ihre Daten abfragen, sofern Sie sie nicht mit einem gemeinsamen Projekt synchronisieren.

Der Snowflake-Konnektor ist in den Abonnements Pro, Max, Enterprise Pro und Enterprise Max verfügbar. Das Generieren einer Datenkarte erfordert Enterprise Pro oder Enterprise Max. In allen Abonnements erstellt eine Snowflake-Administratorin oder ein Snowflake-Administrator mit der Rolle ACCOUNTADMIN die Sicherheitsintegration oder das Dienstkonto; in Enterprise-Abonnements richtet eine Perplexity-Administratorin oder ein Perplexity-Administrator den Konnektor für User OAuth einmalig für die Organisation ein.

​

Datenschutz und Datensicherheit

Der Konnektor fragt Ihr Snowflake-Konto unter einer Snowflake-Rolle ab, die Sie kontrollieren. Die Snowflake-Berechtigungen sind damit die Grenze dafür, worauf Perplexity zugreifen kann. Gewähren Sie dieser Rolle ausschließlich Lesezugriff.

• Zugriffsumfang – Jede Person verbindet ihr eigenes Konto. Niemand sonst in Ihrer Organisation kann Ihre Daten abfragen, sofern Sie sie nicht mit einem gemeinsamen Projekt synchronisieren.

• Speicherort der Daten – Perplexity speichert Ihre Snowflake-Daten nicht. Abfragen laufen gegen Ihr eigenes Snowflake-Konto, und der Konnektor fügt keinen eigenen Speicher hinzu – abgesehen von den betrieblichen Daten, die Perplexity für den Betrieb des Produkts erhebt.

• Aufbewahrung – Der Konnektor betreibt keinen Cache. Es gibt daher keine separate Kopie Ihrer Snowflake-Daten, die aufbewahrt oder gelöscht werden müsste.

• Administratorkontrolle – In Enterprise-Abonnements kann die Administratorin oder der Administrator Ihrer Organisation den Snowflake-Konnektor für Ihre Organisation deaktivieren. In diesem Fall erscheint er nicht in Ihren Konnektor-Einstellungen.

• Durchsetzung von Nur-Lesezugriff – Erzwingen Sie Nur-Lesezugriff über Snowflake-Berechtigungen. Gewähren Sie der von Perplexity verwendeten Rolle keine Berechtigung zum Schreiben oder zum Erstellen von Objekten.

• Verwendung für Training – Daten, auf die über den Snowflake-Konnektor zugegriffen wird, werden niemals zum Training der Modelle von Perplexity oder eines Modells von Dritten verwendet.

• Unterauftragsverarbeiter – Der Authentifizierungs- und API-Verkehr dieses Konnektors läuft über Merge Agent Handler, betrieben von Merge API, Inc., einem Unterauftragsverarbeiter von Perplexity. Die aktuelle Liste wird im Perplexity Trust Center veröffentlicht.

• Verschlüsselung – Konnektor-Anmeldeinformationen und verbundene Daten werden bei der Übertragung mit TLS und im Ruhezustand mit AES-256 verschlüsselt.

• Compliance – Die Kontrollen von Perplexity werden nach SOC 2 Type II geprüft. Dokumentation zu Sicherheit und Compliance finden Sie im Perplexity Trust Center.

​

So aktivieren Sie ihn

​

Auswahl einer Authentifizierungsmethode

Perplexity bietet zwei Snowflake-Konnektoren an. Konfigurieren Sie nur den Konnektor, der zur Authentifizierung Ihrer Benutzer passt.

Konnektor	Abfragen laufen als	Anmeldeinformation	Audit-Trail	Verwenden Sie ihn, wenn
Snowflake (Benutzer-OAuth)	Eigenes Snowflake-Konto jedes Benutzers	OAuth	In den Audit-Protokollen von Snowflake pro Benutzer zugeordnet	Empfohlen für die meisten Organisationen
Snowflake (Dienstkonto)	Ein gemeinsames Dienstkonto	Schlüsselpaar	Gemeinsame Identität	Benutzer fragen über ein einzelnes Konto ab

Tabelle 1 — Die zwei Snowflake-Konnektoren und wann Sie welchen verwenden.

Perplexity empfiehlt dringend den Konnektor „Snowflake (Benutzer-OAuth)“. Abfragen verwenden die eigenen Snowflake-Berechtigungen jeder Person und werden ihr in den Audit-Protokollen von Snowflake zugeordnet.

​

Bevor Sie beginnen

• Sie nutzen das Abonnement Pro, Max, Enterprise Pro oder Enterprise Max.

• In Enterprise-Abonnements: Die Administratorin oder der Administrator Ihrer Organisation hat den Snowflake-Konnektor nicht deaktiviert.

• Ihre Snowflake-Administratorin oder Ihr Snowflake-Administrator verfügt über ACCOUNTADMIN-Zugriff oder gleichwertige Berechtigungen.

• OpenSSL ist lokal installiert – nur für die Einrichtung eines Dienstkontos.

​

Den Konnektor „Snowflake (Benutzer-OAuth)“ einrichten

1. Bitten Sie Ihre Snowflake-Administratorin oder Ihren Snowflake-Administrator, die Sicherheitsintegration zu erstellen. Weitere Parameter finden Sie in der Dokumentation zur OAuth-Sicherheitsintegration von Snowflake.

   USE ROLE ACCOUNTADMIN;
   CREATE SECURITY INTEGRATION PERPLEXITY_OAUTH
     TYPE = OAUTH
     ENABLED = TRUE
     OAUTH_CLIENT = CUSTOM
     OAUTH_CLIENT_TYPE = 'CONFIDENTIAL'
     OAUTH_REDIRECT_URI = 'https://ah.merge.dev/oauth/callback'
     OAUTH_ISSUE_REFRESH_TOKENS = TRUE
     OAUTH_REFRESH_TOKEN_VALIDITY = 7776000
     OAUTH_USE_SECONDARY_ROLES = IMPLICIT
     COMMENT = 'OAuth security integration for Perplexity';
   

2. Rufen Sie die Client-ID und das Client-Secret ab.

   SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('PERPLEXITY_OAUTH');
   

3. Geben Sie diese Anmeldeinformationen im OAuth-Einrichtungsdialog in Perplexity ein.

Verwenden Sie OAUTH_USE_SECONDARY_ROLES = IMPLICIT, damit Benutzer neben ihren Standardrollen auch ihre sekundären Rollen erreichen können. Verwenden Sie NONE, wenn Benutzer in Snowflake auf ihre DEFAULT_ROLE beschränkt sein sollen.

​

Den Konnektor „Snowflake (Dienstkonto)“ einrichten

Ein Dienstkonto ist ein dedizierter Snowflake-Benutzer, der unter einer bestimmten Rolle ausgeführt wird. Alle Personen, die das gemeinsame Konto nutzen, haben denselben Zugriff. Gewähren Sie dieser Rolle daher nur den Datenzugriff, den Perplexity benötigt.

1. Erzeugen Sie in Ihrem lokalen Terminal einen privaten Schlüssel und den passenden öffentlichen Schlüssel.

   openssl genrsa 2048 | openssl pkcs8 -topk8 -inform PEM -out snowflake_computer_key.p8 -nocrypt
   openssl rsa -in snowflake_computer_key.p8 -pubout -out snowflake_computer_key.pub
   

2. Erstellen Sie eine dedizierte Rolle und ein Warehouse und wählen Sie die Warehouse-Größe, die zu Ihrem Abfragevolumen passt. Sie können statt einer Neuerstellung auch ein vorhandenes Warehouse verwenden.

   USE ROLE ACCOUNTADMIN;
   CREATE ROLE IF NOT EXISTS PERPLEXITY_ROLE
     COMMENT = 'Role for Perplexity service account';
   CREATE WAREHOUSE IF NOT EXISTS PERPLEXITY_WAREHOUSE
     WAREHOUSE_SIZE = 'SMALL'
     AUTO_SUSPEND = 60
     AUTO_RESUME = TRUE
     COMMENT = 'Warehouse for Perplexity queries';
   GRANT USAGE ON WAREHOUSE PERPLEXITY_WAREHOUSE
     TO ROLE PERPLEXITY_ROLE;
   

3. Erstellen Sie den Benutzer für das Dienstkonto. Ersetzen Sie den Wert von RSA_PUBLIC_KEY durch den Inhalt von snowflake_computer_key.pub, ohne die Zeilen BEGIN PUBLIC KEY und END PUBLIC KEY.

   CREATE USER PERPLEXITY_USER
     TYPE = SERVICE
     DEFAULT_ROLE = PERPLEXITY_ROLE
     DEFAULT_WAREHOUSE = PERPLEXITY_WAREHOUSE
     COMMENT = 'Service account for Perplexity'
     RSA_PUBLIC_KEY = 'MIIBIjANBgkqhki...your_public_key_here...IDAQAB';
   GRANT ROLE PERPLEXITY_ROLE TO USER PERPLEXITY_USER;
   

4. Gewähren Sie Zugriff auf die Daten, die Perplexity abfragen soll. Ersetzen Sie MY_DATABASE durch Ihre eigene Datenbank. Diese Berechtigungen gewähren Lesezugriff auf ihre vorhandenen und künftigen Schemas, Tabellen und Views. Für einen engeren Zugriff gewähren Sie die Berechtigungen stattdessen für bestimmte Schemas oder Objekte. Siehe die GRANT-Dokumentation von Snowflake.

   GRANT USAGE ON DATABASE MY_DATABASE TO ROLE PERPLEXITY_ROLE;
   GRANT USAGE ON ALL SCHEMAS IN DATABASE MY_DATABASE
     TO ROLE PERPLEXITY_ROLE;
   GRANT USAGE ON FUTURE SCHEMAS IN DATABASE MY_DATABASE
     TO ROLE PERPLEXITY_ROLE;
   GRANT SELECT ON ALL TABLES IN DATABASE MY_DATABASE
     TO ROLE PERPLEXITY_ROLE;
   GRANT SELECT ON FUTURE TABLES IN DATABASE MY_DATABASE
     TO ROLE PERPLEXITY_ROLE;
   GRANT SELECT ON ALL VIEWS IN DATABASE MY_DATABASE
     TO ROLE PERPLEXITY_ROLE;
   GRANT SELECT ON FUTURE VIEWS IN DATABASE MY_DATABASE
     TO ROLE PERPLEXITY_ROLE;
   

5. Wenn Sie im Einrichtungsablauf des Konnektors eine Datenkarte generieren möchten, gewähren Sie Zugriff auf die beiden Account-Usage-Views, die dafür gelesen werden. Das Generieren einer Datenkarte erfordert Enterprise Pro oder Enterprise Max. Diese Berechtigung gewährt einen breiteren Zugriff auf Snowflake-Kontometadaten, nicht nur auf diese beiden Views – prüfen Sie sie daher, bevor Sie sie ausführen.

   View	Verfügbarkeit
   SNOWFLAKE.ACCOUNT_USAGE.QUERY_HISTORY	Alle Editionen
   SNOWFLAKE.ACCOUNT_USAGE.ACCESS_HISTORY	Snowflake Enterprise Edition oder höher. In der Standard Edition verwendet Perplexity stattdessen QUERY_HISTORY

   Tabelle 2 — Die Account-Usage-Views, die eine Datenkarte liest.

   USE ROLE ACCOUNTADMIN;
   GRANT IMPORTED PRIVILEGES ON DATABASE SNOWFLAKE
     TO ROLE PERPLEXITY_ROLE;
   

6. Öffnen Sie Plugins in der Seitenleiste (oder Customize → Connectors, wenn Sie Plugins noch nicht sehen), suchen Sie Snowflake (Dienstkonto) unter Entdecken oder über die Suche und öffnen Sie seine Seite.

7. Wählen Sie Verbinden.

8. Geben Sie die Kennung Ihres Snowflake-Kontos, den Benutzernamen PERPLEXITY_USER und den privaten Schlüssel snowflake_computer_key.p8 ein.

9. Wählen Sie Zulassen, um die Einrichtung abzuschließen.

Halten Sie snowflake_computer_key.p8 geheim. Sie geben ihn beim Verbinden in Perplexity ein, und alle anderen, die ihn besitzen, können Ihr Warehouse als PERPLEXITY_USER abfragen. Erzwingen Sie Nur-Lesezugriff über Snowflake-Berechtigungen: Gewähren Sie PERPLEXITY_ROLE keine Berechtigungen zum Schreiben oder zum Erstellen von Objekten.

​

Ihr Snowflake-Konto verbinden

Sobald die Einrichtung durch die Administration abgeschlossen ist, verbindet jeder Benutzer sein eigenes Konto.

1. Öffnen Sie Plugins in der Seitenleiste (oder Customize → Connectors, wenn Sie Plugins noch nicht sehen), suchen Sie Snowflake (Benutzer-OAuth) unter Entdecken oder über die Suche und öffnen Sie seine Seite.

2. Wählen Sie Verbinden.

3. Melden Sie sich bei Snowflake an, wenn Sie dazu aufgefordert werden.

4. Wählen Sie Zulassen, um die Verbindung abzuschließen.

Dieser Konnektor kann auch Teil eines Plugins sein. Wenn Sie ihn an einer Stelle verbinden, ist er überall für Ihr Konto verbunden. Ihre Verbindung und die Konnektoreinstellungen Ihrer Organisation gelten in jedem Plugin. Was sind Plugins?

​

So prüfen Sie, ob es funktioniert hat

Öffnen Sie eine neue Sitzung, erwähnen Sie @Snowflake und fragen Sie etwas Kleines aus einer Tabelle ab, die Sie in Snowflake bereits lesen können, zum Beispiel eine Zeilenanzahl. Wenn die Antwort ohne Ihre Snowflake-Daten zurückkommt, prüfen Sie zuerst Ihre Snowflake-Rolle: Sie benötigt SELECT für das genannte Objekt.

​

Ausprobieren

Sobald Snowflake verbunden ist, erwähnen Sie es in einer neuen Sitzung:

• @Snowflake Wie viele Zeilen enthält die Tabelle orders?

• @Snowflake Welche Spalten enthält die Tabelle customers?

• @Snowflake Listen Sie die Schemas auf, die ich in MY_DATABASE abfragen kann

​

Berechtigungen und Geltungsbereiche

Der Konnektor benötigt ausschließlich Leseberechtigungen. Gewähren Sie sie einer dedizierten Rolle und nicht einer vorhandenen Analystenrolle.

Berechtigung	Gewährt für	Warum der Konnektor sie benötigt
USAGE	Warehouse	Ausführen der Abfragen, die eine Frage beantworten
USAGE	Datenbank und Schemas	Erreichen der Objekte, die abgefragt werden dürfen
SELECT	Tabellen und Views	Lesen von Zeilen. Es wird keine Schreibberechtigung angefordert
IMPORTED PRIVILEGES	SNOWFLAKE-Datenbank	Lesen der beiden Account-Usage-Views, die eine Datenkarte benötigt. Optional
Refresh-Token	Sicherheitsintegration	Eine Benutzerverbindung ohne erneute Authentifizierung für die von Ihnen festgelegte Gültigkeitsdauer aufrechterhalten

Tabelle 3 — Snowflake-Berechtigungen, die der Konnektor anfordert, und warum.

Die Snowflake-Berechtigungen sind die Durchsetzungsgrenze. Was auch immer der Konnektor tun soll: Er läuft unter der von Ihnen gewährten Rolle, sodass eine Rolle ohne Schreibberechtigungen nicht schreiben kann.

​

Fehlerbehebung

Beobachtetes Symptom	Wahrscheinlichste Ursache	So beheben Sie es
Snowflake ist für Ihre Organisation nicht aktiviert oder erscheint nicht in Ihrer Konnektor-Liste	In Enterprise-Abonnements hat eine Administratorin oder ein Administrator der Organisation ihn deaktiviert. Andernfalls ist er möglicherweise nicht in Ihrem Abonnement enthalten	Wenden Sie sich in Enterprise-Abonnements an die Administration Ihrer Organisation. Prüfen Sie andernfalls Ihr Abonnement unter Einstellungen
Anmeldung oder Abfragen schlagen fehl, und Ihr Snowflake-Konto beschränkt eingehende Verbindungen nach IP	Die Merge-Tenant-Adressen stehen nicht auf der Zulassungsliste Ihrer Snowflake-Netzwerkrichtlinie	Bitten Sie Ihre Snowflake-Administration, die US-Tenant-Adressen von der Seite mit den Merge-Tenant-IP-Adressen auf die Zulassungsliste zu setzen
Ein Benutzer erreicht weniger Daten, als ihm in Snowflake gewährt wurden	Die OAuth-Sitzung hat nur seine DEFAULT_ROLE aktiviert	Bestätigen Sie, dass die Sicherheitsintegration OAUTH_USE_SECONDARY_ROLES = IMPLICIT setzt
ACCESS_HISTORY ist beim Generieren einer Datenkarte nicht verfügbar	Ihr Snowflake-Konto nutzt die Standard Edition	ACCESS_HISTORY benötigt die Enterprise Edition oder höher. In der Standard Edition verwendet Perplexity stattdessen QUERY_HISTORY

Tabelle 4 — Symptom, Ursache und Lösung für die häufigsten Probleme mit dem Snowflake-Konnektor.

Für ein Dienstkonto erstellt dieses Beispiel eine Netzwerkrichtlinie auf Benutzerebene mit den derzeit veröffentlichten US-Adressen. Prüfen Sie die Seite mit den Merge-Tenant-IP-Adressen auf die aktuelle Liste, bevor Sie eine Richtlinie anwenden.

USE ROLE ACCOUNTADMIN;
CREATE NETWORK POLICY PERPLEXITY_COMPUTER_POLICY
  ALLOWED_IP_LIST = ('3.216.101.38', '52.20.242.81');
ALTER USER PERPLEXITY_USER
  SET NETWORK_POLICY = PERPLEXITY_COMPUTER_POLICY;

​

Häufig gestellte Fragen

​

Auf welche Daten greift dieser Konnektor zu?

Auf die Datenbanken, Schemas, Tabellen und Views, die die von Ihnen gewährte Snowflake-Rolle lesen darf. Er kann nichts erreichen, was diese Rolle nicht erreichen kann.

​

Werden meine Snowflake-Daten zum Training von KI-Modellen verwendet?

Nein. Daten, auf die über den Snowflake-Konnektor zugegriffen wird, werden niemals zum Training der Modelle von Perplexity oder eines Modells von Dritten verwendet.

​

Kann meine Administration einschränken, wer diesen Konnektor aktiviert?

Ja, in Enterprise-Abonnements. Eine Administratorin oder ein Administrator der Organisation kann den Snowflake-Konnektor für die gesamte Organisation deaktivieren. In diesem Fall erscheint er nicht in Ihren Konnektor-Einstellungen.

​

Kann Perplexity in meine Snowflake-Daten schreiben?

Nein, sofern Sie dies in Snowflake erzwingen. Gewähren Sie der von Perplexity verwendeten Rolle nur USAGE und SELECT, dann lehnt Snowflake jeden Schreibvorgang ab, unabhängig davon, was Perplexity tun soll.

​

Ist dieser Konnektor in meinem Abonnement verfügbar?

Ja, in den Abonnements Pro, Max, Enterprise Pro und Enterprise Max. Das Generieren einer Datenkarte erfordert Enterprise Pro oder Enterprise Max.

​

Verwandte Artikel

• Data Map verstehen

• Perplexity mit Databricks verbinden

• Leitfaden zur Fehlerbehebung für Enterprise Connectors

• Datenaufbewahrung und Datenschutz für Enterprise

• Enterprise-Rollen und Berechtigungen

​

Benötigen Sie weitere Hilfe?

Wenn Sie uns schreiben, geben Sie den Namen des Konnektors, die genaue Fehlermeldung, den Zeitpunkt des Auftretens und die Schritte aus diesem Artikel an, die das Problem nicht gelöst haben.

Wenden Sie sich an Ihr Account-Team oder kontaktieren Sie uns über „Help“ > „Support kontaktieren“. Dokumentation zu Sicherheit und Compliance finden Sie im Trust Center.