Verbinding maken een Azure Cosmos DB-database naar uw toepassing in Azure Spring Apps
Notitie
Azure Spring Apps is de nieuwe naam voor de Azure Spring Cloud-service. Hoewel de service een nieuwe naam heeft, ziet u de oude naam op sommige plaatsen terwijl we werken aan het bijwerken van assets, zoals schermopnamen, video's en diagrammen.
Dit artikel is van toepassing op: ✔️ Java ✔️ C#
Dit artikel is van toepassing op: ✔️ Basic/Standard ✔️ Enterprise
In plaats van uw Spring Boot-toepassingen handmatig te configureren, kunt u automatisch geselecteerde Azure-services verbinden met uw toepassingen met behulp van Azure Spring Apps. Dit artikel laat zien hoe u uw toepassing verbindt met een Azure Cosmos DB-database.
Vereisten
- Een toepassing die is geïmplementeerd in Azure Spring Apps. Zie quickstart: Uw eerste toepassing implementeren in Azure Spring Apps voor meer informatie.
- Een Azure Cosmos DB-database-exemplaar.
- Azure CLI versie 2.45.0 of hoger.
Uw project voorbereiden
Voeg een van de volgende afhankelijkheden toe aan het pom.xml-bestand van uw toepassing. Kies de afhankelijkheid die geschikt is voor uw type API.
API-type: NoSQL
<dependency> <groupId>com.azure.spring</groupId> <artifactId>spring-cloud-azure-starter-data-cosmos</artifactId> </dependency>
API-type: MongoDB
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-data-mongodb</artifactId> </dependency>
API-type: Cassandra
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-data-cassandra</artifactId> </dependency>
Werk de huidige app bij door deze wijziging uit te voeren
az spring app deploy
of maak een nieuwe implementatie voor deze wijziging door uit te voerenaz spring app deployment create
.
Verbinding maken uw app naar Azure Cosmos DB
Notitie
Service Verbinding maken ors worden standaard gemaakt op toepassingsniveau. Als u de verbindingen wilt overschrijven, kunt u andere verbindingen opnieuw maken in de implementaties.
De Azure CLI gebruiken
Gebruik de Azure CLI om uw Spring-app te configureren om verbinding te maken met een Cosmos NoSQL-database met behulp van de az spring connection create
opdracht, zoals wordt weergegeven in het volgende voorbeeld. Zorg ervoor dat u de variabelen in het voorbeeld vervangt door werkelijke waarden.
Notitie
Het bijwerken van azure Cosmos DB-database-instellingen kan enkele minuten duren.
Notitie
Als u Cosmos Cassandra gebruikt, gebruikt --key_space
u in plaats van --database
. Als u Cosmos Table gebruikt, gebruikt --table
u in plaats van --database
. Zie quickstart: Een serviceverbinding maken in Azure Spring Apps met de Azure CLI voor meer informatie.
az spring connection create cosmos-sql \
--resource-group $AZURE_SPRING_APPS_RESOURCE_GROUP \
--service $AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME \
--app $APP_NAME \
--target-resource-group $COSMOSDB_RESOURCE_GROUP \
--account $COSMOSDB_ACCOUNT_NAME \
--database $DATABASE_NAME \
--secret
Notitie
Als u Service Verbinding maken or voor de eerste keer gebruikt, start u met de opdracht az provider register --namespace Microsoft.ServiceLinker
om de service-Verbinding maken or-resourceprovider te registreren.
Tip
Voer de opdracht az spring connection list-support-types --output table
uit om een lijst met ondersteunde doelservices en verificatiemethoden voor Azure Spring Apps op te halen. Als de az spring
opdracht niet wordt herkend door het systeem, controleert u of u de vereiste extensie hebt geïnstalleerd door uit te voeren az extension add --name spring
.
De Azure-portal gebruiken
U kunt azure Portal ook gebruiken om deze verbinding te configureren door de volgende stappen uit te voeren. Azure Portal biedt dezelfde mogelijkheden als de Azure CLI en biedt een interactieve ervaring.
Selecteer uw Azure Spring Apps-exemplaar in Azure Portal en selecteer Apps in het navigatiemenu. Kies de app waarmee u verbinding wilt maken en selecteer Service Verbinding maken or in het navigatiemenu.
Selecteer Maken.
Selecteer Cosmos DB op het tabblad Basis voor servicetype en kies vervolgens een abonnement. Voor API-type selecteert u Core (SQL), kiest u een Cosmos DB-account en een database. Voor clienttype selecteert u Java en selecteert u vervolgens Volgende: Verificatie. Als u uw database nog niet hebt gemaakt, raadpleegt u quickstart: Een Azure Cosmos DB-account, -database, -container en -items maken vanuit Azure Portal.
Kies op het tabblad Verificatie Verbinding maken iontekenreeks. Service Verbinding maken or haalt automatisch de toegangssleutel op uit uw Cosmos DB-account. Selecteer Volgende: Netwerken.
Selecteer op het tabblad Netwerken firewallregels configureren om toegang tot de doelservice in te schakelen en selecteer vervolgens Volgende: Beoordelen en maken.
Wacht op het tabblad Controleren en maken totdat de validatie is geslaagd en selecteer vervolgens Maken. Het maken kan enkele minuten duren.
Zodra de verbinding tussen uw Spring-apps en uw Cosmos DB-database is gegenereerd, kunt u deze zien op de pagina Service Verbinding maken or en de knop Uitvouwen selecteren om de geconfigureerde verbindingsvariabelen weer te geven.
Volgende stappen
In dit artikel hebt u geleerd hoe u uw toepassing in Azure Spring Apps verbindt met een Azure Cosmos DB-database. Zie Verbinding maken naar een Azure Cache voor Redis cache voor meer informatie over het verbinden van services met uw toepassing.
Feedback
https://aka.ms/ContentUserFeedback.
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie:Feedback verzenden en weergeven voor