

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Verbindung zu Azure Cosmos DB in AWS Glue Studio herstellen
<a name="connecting-to-data-azurecosmos"></a>

 AWS Glue bietet integrierte Unterstützung für Azure Cosmos DB. AWS Glue Studio stellt eine visuelle Benutzeroberfläche bereit, um eine Verbindung zu Azure Cosmos DB for NoSQL herzustellen, Datenintegrationsaufträge zu verfassen und diese in der AWS Glue Studio-Serverless-Spark-Laufzeit auszuführen. 

**Topics**
+ [Erstellen einer Azure-Cosmos-DB-Verbindung](creating-azurecosmos-connection.md)
+ [Erstellen eines Azure-Cosmos-DB-Quellknotens](creating-azurecosmos-source-node.md)
+ [Erstellen eines Azure-Cosmos-DB-Zielknotens](creating-azurecosmos-target-node.md)
+ [Erweiterte Optionen](#creating-azurecosmos-connection-advanced-options)

# Erstellen einer Azure-Cosmos-DB-Verbindung
<a name="creating-azurecosmos-connection"></a>

**Voraussetzungen:**
+ In Azure müssen Sie einen Azure Cosmos DB-Schlüssel für die Verwendung durch AWS Glue, `cosmosKey` identifizieren oder generieren. Weitere Informationen finden Sie unter [Sicherer Zugriff auf Daten in Azure Cosmos DB](https://learn.microsoft.com/en-us/azure/cosmos-db/secure-access-to-data?tabs=using-primary-key) in der Azure-Dokumentation.

**Eine Verbindung zu Azure Cosmos DB konfigurieren Sie wie folgt:**

1. Erstellen Sie in AWS Secrets Manager ein Geheimnis mit Ihrem Azure Cosmos DB-Schlüssel. Um ein Geheimnis in Secrets Manager zu erstellen, folgen Sie dem Tutorial, das in der AWS Secrets Manager Dokumentation unter [Create an AWS Secrets Manager Secret](https://docs.aws.amazon.com//secretsmanager/latest/userguide/create_secret.html) verfügbar ist. Nachdem Sie das Geheimnis erstellt haben, behalten Sie den Geheimnamen *secretName* für den nächsten Schritt bei. 
   + Wenn Sie **Schlüssel/Wert-Paare** auswählen, erstellen Sie ein Paar für den Schlüssel `spark.cosmos.accountKey` mit dem Wert. *cosmosKey*

1. Stellen Sie in der AWS Glue Konsole eine Verbindung her, indem Sie den Schritten unter folgen. [AWS Glue Verbindung hinzufügen](console-connections.md) Nachdem Sie die Verbindung hergestellt haben, behalten Sie den Verbindungsnamen,*connectionName*, für die future Verwendung in AWS Glue. 
   + Wählen Sie als **Verbindungstyp** Azure Cosmos DB aus.
   + Geben Sie bei der Auswahl eines **AWS Geheimnisses** Folgendes an*secretName*.

# Erstellen eines Azure-Cosmos-DB-Quellknotens
<a name="creating-azurecosmos-source-node"></a>

## Voraussetzungen
<a name="creating-azurecosmos-source-node-prerequisites"></a>
+ Eine AWS Glue Azure Cosmos DB-Verbindung, konfiguriert mit einem AWS Secrets Manager Geheimnis, wie im vorherigen Abschnitt beschrieben,[Erstellen einer Azure-Cosmos-DB-Verbindung](creating-azurecosmos-connection.md).
+ Entsprechende Berechtigungen für Ihren Auftrag zum Lesen des von der Verbindung verwendeten Secrets.
+ Ein Container in Azure Cosmos DB für NoSQL, aus dem Sie lesen möchten. Sie benötigen Identifikationsinformationen für den Container.

  Ein Container in Azure Cosmos DB für NoSQL wird anhand seiner Datenbank und seines Containers identifiziert. Sie müssen die Datenbank- und Container-Namen angeben*cosmosContainerName*, wenn Sie eine Verbindung zur Azure Cosmos for NoSQL-API herstellen. *cosmosDBName*

## Hinzufügen einer Azure-Cosmos-DB-Datenquelle
<a name="creating-azurecosmos-source-node-add"></a>

**Fügen Sie einen Knoten **Datenquelle – Azure Cosmos DB** wie folgt hinzu:**

1.  Wählen Sie die Verbindung für Ihre Azure-Cosmos-DB-Datenquelle aus. Da Sie sie erstellt haben, sollte sie in der Dropdown-Liste verfügbar sein. Wenn Sie eine Verbindung erstellen müssen, wählen Sie **Azure-Cosmos-DB-Verbindung erstellen** aus. Weitere Informationen finden Sie im vorhergehenden Abschnitt [Erstellen einer Azure-Cosmos-DB-Verbindung](creating-azurecosmos-connection.md). 

    Nachdem Sie eine Verbindung ausgewählt haben, können Sie die Verbindungseigenschaften anzeigen, indem Sie auf **Eigenschaften anzeigen** klicken. 

1. Wählen Sie **Cosmos DB-Datenbankname** — geben Sie den Namen der Datenbank an, aus der Sie lesen möchten,. *cosmosDBName*

1. Wählen Sie **Azure Cosmos DB Container** — geben Sie den Namen des Containers ein, aus dem Sie lesen möchten,. *cosmosContainerName*

1. Wählen Sie optional **Benutzerdefinierte Abfrage in Azure Cosmos DB** aus – geben Sie eine SQL-SELECT-Abfrage ein, um bestimmte Informationen aus Azure Cosmos DB abzurufen.

1.  Geben Sie unter **Benutzerdefinierte Azure-Cosmos-Eigenschaften** nach Bedarf Parameter und Werte ein. 

# Erstellen eines Azure-Cosmos-DB-Zielknotens
<a name="creating-azurecosmos-target-node"></a>

## Voraussetzungen
<a name="creating-azurecosmos-target-node-prerequisites"></a>
+ Eine AWS Glue Azure Cosmos DB-Verbindung, konfiguriert mit einem AWS Secrets Manager Geheimnis, wie im vorherigen Abschnitt beschrieben,[Erstellen einer Azure-Cosmos-DB-Verbindung](creating-azurecosmos-connection.md).
+ Entsprechende Berechtigungen für Ihren Auftrag zum Lesen des von der Verbindung verwendeten Secrets.
+ Eine Azure-Cosmos-DB-Tabelle, in die Sie schreiben möchten. Sie benötigen Identifikationsinformationen für den Container. **Sie müssen den Container erstellen, bevor Sie die Verbindungsmethode aufrufen.**

  Ein Container in Azure Cosmos DB für NoSQL wird anhand seiner Datenbank und seines Containers identifiziert. Sie müssen die Datenbank- und Container-Namen angeben*cosmosContainerName*, wenn Sie eine Verbindung zur Azure Cosmos for NoSQL-API herstellen. *cosmosDBName*

## Hinzufügen eines Azure-Cosmos-DB-Datenziels
<a name="creating-azurecosmos-target-node-add"></a>

**Fügen Sie einen Knoten **Datenziel – Azure Cosmos DB** wie folgt hinzu:**

1.  Wählen Sie die Verbindung für Ihre Azure-Cosmos-DB-Datenquelle aus. Da Sie sie erstellt haben, sollte sie in der Dropdown-Liste verfügbar sein. Wenn Sie eine Verbindung erstellen müssen, wählen Sie **Azure-Cosmos-DB-Verbindung erstellen** aus. Weitere Informationen finden Sie im vorhergehenden Abschnitt [Erstellen einer Azure-Cosmos-DB-Verbindung](creating-azurecosmos-connection.md). 

    Nachdem Sie eine Verbindung ausgewählt haben, können Sie die Verbindungseigenschaften anzeigen, indem Sie auf **Eigenschaften anzeigen** klicken. 

1. Wählen Sie **Cosmos DB-Datenbankname** — geben Sie den Namen der Datenbank an, aus der Sie lesen möchten,. *cosmosDBName*

1. Wählen Sie **Azure Cosmos DB Container** — geben Sie den Namen des Containers ein, aus dem Sie lesen möchten,. *cosmosContainerName*

1.  Geben Sie unter **Benutzerdefinierte Azure-Cosmos-Eigenschaften** nach Bedarf Parameter und Werte ein. 

## Erweiterte Optionen
<a name="creating-azurecosmos-connection-advanced-options"></a>

Sie können bei der Erstellung eines Azure-Cosmos-DB-Knotens erweiterte Optionen angeben. Diese Optionen sind dieselben wie die, die bei der Programmierung AWS Glue für Spark-Skripte verfügbar sind.

Siehe [Azure-Cosmos-DB-Verbindungen](aws-glue-programming-etl-connect-azurecosmos-home.md). 