Connessione un database di Azure Cosmos DB all'applicazione in Azure Spring Apps
Nota
Azure Spring Apps è il nuovo nome del servizio Azure Spring Cloud. Anche se il servizio ha un nuovo nome, il nome precedente verrà visualizzato in alcune posizioni per un po' mentre si lavora per aggiornare gli asset, ad esempio screenshot, video e diagrammi.
Questo articolo si applica a: ✔️ Java ✔️ C#
Questo articolo si applica a: ✔️ Basic/Standard ✔️ Enterprise
Invece di configurare manualmente le applicazioni Spring Boot, è possibile connettere automaticamente i servizi di Azure selezionati alle applicazioni usando Azure Spring Apps. Questo articolo illustra come connettere l'applicazione a un database di Azure Cosmos DB.
Prerequisiti
- Un'applicazione distribuita in Azure Spring Apps. Per altre informazioni, vedere Avvio rapido: Distribuire la prima applicazione in Azure Spring Apps.
- Istanza del database Azure Cosmos DB.
- Interfaccia della riga di comando di Azure versione 2.45.0 o successiva.
Preparare il progetto
Aggiungere una delle dipendenze seguenti al file di pom.xml dell'applicazione. Scegliere la dipendenza appropriata per il tipo di API.
Tipo di API: NoSQL
<dependency> <groupId>com.azure.spring</groupId> <artifactId>spring-cloud-azure-starter-data-cosmos</artifactId> </dependency>
Tipo di API: MongoDB
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-data-mongodb</artifactId> </dependency>
Tipo di API: Cassandra
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-data-cassandra</artifactId> </dependency>
Aggiornare l'app corrente eseguendo
az spring app deploy
o creare una nuova distribuzione per questa modifica eseguendoaz spring app deployment create
.
Connessione'app ad Azure Cosmos DB
Nota
Per impostazione predefinita, i Connessione or di servizio vengono creati a livello di applicazione. Per eseguire l'override delle connessioni, è possibile creare di nuovo altre connessioni nelle distribuzioni.
Usare l'interfaccia della riga di comando di Azure
Usare l'interfaccia della riga di comando di Azure per configurare l'app Spring per connettersi a un'istanza di Cosmos No database SQL usando il az spring connection create
comando , come illustrato nell'esempio seguente. Assicurarsi di sostituire le variabili nell'esempio con i valori effettivi.
Nota
Il completamento dell'aggiornamento delle impostazioni del database di Azure Cosmos DB può richiedere alcuni minuti.
Nota
Se si usa Cosmos Cassandra, usare --key_space
anziché --database
. Se si usa Cosmos Table, usare --table
anziché --database
. Per altre informazioni, vedere Avvio rapido: Creare una connessione al servizio in Azure Spring Apps con l'interfaccia della riga di comando di Azure.
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
Nota
Se si usa service Connessione or per la prima volta, iniziare eseguendo il comando az provider register --namespace Microsoft.ServiceLinker
per registrare il provider di risorse service Connessione or.
Suggerimento
Eseguire il comando az spring connection list-support-types --output table
per ottenere un elenco dei servizi di destinazione e dei metodi di autenticazione supportati per Azure Spring Apps. Se il az spring
comando non è riconosciuto dal sistema, verificare di aver installato l'estensione richiesta eseguendo az extension add --name spring
.
Usare il portale di Azure
In alternativa, è possibile usare il portale di Azure per configurare questa connessione completando i passaggi seguenti. Il portale di Azure offre le stesse funzionalità dell'interfaccia della riga di comando di Azure e offre un'esperienza interattiva.
Selezionare l'istanza di Azure Spring Apps nel portale di Azure e selezionare App dal menu di spostamento. Scegliere l'app da connettere e selezionare Service Connessione or nel menu di spostamento.
Seleziona Crea.
Nella scheda Informazioni di base selezionare Cosmos DB per tipo di servizio e quindi scegliere una sottoscrizione. Per Tipo di API selezionare Core (SQL), scegliere un account Cosmos DB e un database. Per tipo di client selezionare Java, quindi selezionare Avanti: Autenticazione. Se il database non è ancora stato creato, vedere Avvio rapido: Creare un account, un database, un contenitore e elementi di Azure Cosmos DB dall'portale di Azure.
Nella scheda Autenticazione scegliere Connessione stringa di Connessione. Service Connessione or recupera automaticamente la chiave di accesso dall'account Cosmos DB. Al termine, selezionare Avanti: Rete.
Nella scheda Rete selezionare Configura regole del firewall per abilitare l'accesso al servizio di destinazione, quindi selezionare Avanti: Rivedi e crea.
Nella scheda Rivedi e crea attendere il superamento della convalida e quindi selezionare Crea. Il completamento della creazione può richiedere alcuni minuti.
Dopo aver generato la connessione tra le app Spring e il database Cosmos DB, è possibile visualizzarla nella pagina Service Connessione or e selezionare il pulsante di distribuzione per visualizzare le variabili di connessione configurate.
Passaggi successivi
In questo articolo si è appreso come connettere l'applicazione in Azure Spring Apps a un database di Azure Cosmos DB. Per altre informazioni sulla connessione dei servizi all'applicazione, vedere Connessione a una cache di cache di Azure per Redis.
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per