Schnellstart: Herstellen einer Verbindung mit Azure Synapse Link für Azure Cosmos DB
In diesem Artikel wird beschrieben, wie Sie über Azure Synapse Analytics Studio mit Synapse Link auf eine Azure Cosmos DB-Datenbank zugreifen.
Voraussetzungen
Sie benötigen Folgendes, um eine Verbindung zwischen einem Azure Cosmos DB-Konto und Ihrem Arbeitsbereich herstellen zu können:
- Ein vorhandenes Azure Cosmos DB-Konto. Erstellen Sie alternativ anhand dieser Schnellstartanleitung ein neues Konto.
- Einen vorhandenen Synapse-Arbeitsbereich. Erstellen Sie alternativ anhand dieser Schnellstartanleitung einen neuen Arbeitsbereich.
Aktivieren des Azure Cosmos DB-Analysespeichers
Es empfiehlt sich, Synapse Link für Azure Cosmos DB zu aktivieren, wenn Sie umfangreiche Analysen in Azure Cosmos DB ohne Beeinträchtigung der betrieblichen Leistung ausführen möchten. Diese Funktion stellt HTAP-Funktionen für Container sowie integrierte Unterstützung in Azure Synapse bereit. Befolgen Sie diese Schnellstartanleitung, um Synapse Link für Azure Cosmos DB-Container zu aktivieren.
Navigieren zu Synapse Studio
Wählen Sie in Ihrem Synapse-Arbeitsbereich die Option Synapse Studio starten aus. Wählen Sie auf der Synapse Studio-Startseite „Daten“ aus. Dadurch gelangen Sie zum Datenobjekt-Explorer.
Herstellen einer Verbindung zwischen einer Azure Cosmos DB-Datenbank und einem Synapse-Arbeitsbereich
Die Verbindung mit einer Azure Cosmos DB-Datenbank wird über einen verknüpften Dienst hergestellt. Ein verknüpfter Azure Cosmos DB-Dienst ermöglicht Benutzern das Durchsuchen und Untersuchen von Daten sowie Lese- und Schreibvorgänge von Apache Spark für Azure Synapse Analytics oder SQL in Azure Cosmos DB.
Über den Datenobjekt-Explorer können Sie mithilfe der folgenden Schritte direkt eine Verbindung für eine Azure Cosmos DB-Datenbank herstellen:
- Wählen Sie neben „Daten“ das Symbol + aus.
- Wählen Sie Connect to external data (Verbindung mit externen Daten herstellen) aus.
- Wählen Sie die API aus, mit der Sie eine Verbindung herstellen möchten: SQL oder MongoDB
- Wählen Sie Weiter aus.
- Geben Sie einen Namen für den verknüpften Dienst ein. Der Name wird im Objekt-Explorer angezeigt und von Synapse-Laufzeiten verwendet, um eine Verbindung mit der Datenbank und den Containern herzustellen. Es wird empfohlen, einen Anzeigenamen zu verwenden.
- Wählen Sie den Cosmos DB-Kontonamen und den Datenbanknamen aus.
- (Optional) Wird keine Region angegeben, werden Synapse-Laufzeitvorgänge an die nächstgelegene Region weitergeleitet, in der der Analysespeicher aktiviert ist. Sie können jedoch manuell die Region festlegen, in der Ihre Benutzer auf den Azure Cosmos DB-Analysespeicher zugreifen sollen. Wählen Sie Additional connection properties (Zusätzliche Verbindungseigenschaften) und dann Neu aus. Geben Sie unter Eigenschaftenname den Namen PreferredRegions ein, und legen Sie unter Wert die gewünschte Region fest (etwa „WestUS2“, ohne Leerstelle zwischen Wort und Zahl).
- Wählen Sie Erstellen aus.
Azure Cosmos DB-Datenbanken werden im Azure Cosmos DB-Abschnitt auf der Registerkarte Verknüpft angezeigt. Anhand der folgenden Symbole können Sie einen HTAP-fähigen Azure Cosmos DB-Container von einem reinen OLTP-Container unterscheiden:
Synapse-Container:
Reiner OLTP-Container:
Schnelles Interagieren mit durch Code generierte Aktionen
Wenn Sie mit der rechten Maustaste in einen Container klicken, wird eine Liste mit Gesten angezeigt, die eine Spark- oder SQL-Laufzeit auslösen. Das Schreiben in einen Container erfolgt über den Transaktionsspeicher von Azure Cosmos DB und verbraucht Anforderungseinheiten.