In questa pagina scoprirai come utilizzare l'API Database Migration Service per gestire i profili di connessione per un database di origine PostgreSQL e una destinazione AlloyDB.
Puoi utilizzare l'API Database Migration Service in due modi. Puoi effettuare chiamate all'API REST o utilizzare Google Cloud CLI (interfaccia a riga di comando).
Per informazioni di alto livello sull'utilizzo di gcloud per gestire i profili di connessione di Database Migration Service, fai clic qui.
Crea un profilo di connessione per un database di origine PostgreSQL
Di seguito è riportata una richiesta di creazione di un profilo di connessione per un database di origine PostgreSQL.
REST
Prima di utilizzare i dati della richiesta,
apporta le seguenti sostituzioni:
project-id: l'ID progetto
region: la regione del progetto
connection-profile-id: l'ID profilo di connessione
connection-profile-display-name: il nome visualizzato del profilo di connessione
host-ip-address: l'indirizzo IP di origine
username: il nome utente del database
password: la password dell'utente del database
Metodo HTTP e URL:
POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id
Corpo JSON della richiesta:
Per inviare la richiesta, espandi una di queste opzioni:
curl (Linux, macOS o Cloud Shell)
Salva il corpo della richiesta in un file denominato request.json,
quindi esegui il comando seguente:
Dovresti ricevere una risposta JSON simile alla seguente:
gcloud
Per ulteriori informazioni sull'utilizzo di gcloud per recuperare informazioni sul profilo di connessione, fai clic qui.
Creare un profilo di connessione per un database di origine Cloud SQL per PostgreSQL
Di seguito è riportata una richiesta di creazione di un profilo di connessione per un database di origine Cloud SQL per PostgreSQL. Questo esempio utilizza un profilo di connessione PostgreSQL perché si connette al motore del database PostgreSQL e non al livello di gestione Cloud SQL.
Per creare l'accoppiamento tra l'origine e la replica utilizzando Cloud SQL, devi fornire l'ID istanza per il tuo database Cloud SQL. Puoi trovare il valore dell'ID istanza utilizzando il metodo
databases/list
dell'API Cloud SQL Admin.
REST
Prima di utilizzare i dati della richiesta,
apporta le seguenti sostituzioni:
project-id: l'ID progetto
region: la regione del progetto
connection-profile-id: l'ID profilo di connessione
connection-profile-display-name: il nome visualizzato del profilo di connessione
host-ip-address: l'indirizzo IP di origine
username: il nome utente del database
password: la password dell'utente del database
cloud-sql-instance-id: l'ID istanza Cloud SQL
Metodo HTTP e URL:
POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id
Corpo JSON della richiesta:
Per inviare la richiesta, espandi una di queste opzioni:
curl (Linux, macOS o Cloud Shell)
Salva il corpo della richiesta in un file denominato request.json,
quindi esegui il comando seguente:
Per informazioni di alto livello sull'utilizzo di gcloud per creare profili di connessione di Database Migration Service, fai clic qui.
Creare un profilo di connessione per una destinazione AlloyDB per PostgreSQL
Di seguito è riportata una richiesta di creazione di un profilo di connessione per una destinazione AlloyDB per PostgreSQL.
Database Migration Service utilizza le informazioni in questa richiesta per creare una nuova istanza AlloyDB.
REST
Prima di utilizzare i dati della richiesta,
apporta le seguenti sostituzioni:
project-id: l'ID progetto
region: la regione del progetto
connection-profile-id: l'ID profilo di connessione
connection-profile-display-name: il nome visualizzato del profilo di connessione
cluster-id: l'ID del cluster AlloyDB da creare
user: il nome utente da assegnare all'utente iniziale
password: la password da assegnare all'utente iniziale
vpc-network: la rete VPC a cui verrà connesso il cluster AlloyDB
instance-id: l'ID istanza AlloyDB da creare
cpu-count: il numero di CPU con cui configurare l'istanza
Tutti i dati archiviati in Google Cloud sono criptati a riposo utilizzando gli stessi sistemi di gestione delle chiavi rafforzati che utilizziamo per i nostri dati criptati. Questi sistemi di gestione delle chiavi forniscono controlli e verifiche rigorosi dell'accesso alle chiavi e criptano i dati utente at-rest utilizzando gli standard di crittografia AES-256. Non è richiesta alcuna configurazione o gestione.La crittografia at-rest predefinita di Google Cloudè la scelta migliore per gli utenti che non hanno requisiti specifici relativi alla conformità o alla località del materiale crittografico.
Metodo HTTP e URL:
POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles?connectionProfileId=connection-profile-id
Dovresti ricevere una risposta JSON simile alla seguente:
gcloud
Per ulteriori informazioni sull'utilizzo di gcloud per recuperare informazioni sul profilo di connessione, fai clic qui.
Elenca i profili di connessione
Di seguito è riportata una richiesta per recuperare informazioni su tutti i tuoi profili di connessione.
REST
Prima di utilizzare i dati della richiesta,
apporta le seguenti sostituzioni:
project-id: l'ID progetto
region: la regione del progetto
Puoi anche filtrare l'elenco dei profili di connessione recuperati da Database Migration Service come segue:
orderBy: Utilizza questo filtro per recuperare un elenco di tutti i profili di connessione per una determinata regione in ordine alfabetico. Ad esempio, il filtro orderBy=name restituisce tutti i profili di connessione in ordine alfabetico per nome.
pageSize: Utilizza questo filtro per specificare il numero massimo di profili di connessione che Database Migration Service recupera e mostra in una pagina. Ad esempio, impostando pageSize=10, Database Migration Service restituirà fino a 10 profili di connessione per una pagina.
Se sono presenti più di 10 profili di connessione, questi vengono visualizzati in altre pagine. Alla fine di ogni pagina vengono visualizzati un parametro nextPageToken e un identificatore univoco. Utilizza l'identificatore per recuperare l'elenco dei profili di connessione per la pagina seguente.
Metodo HTTP e URL:
GET https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
gcloud
Per ulteriori informazioni sull'utilizzo di gcloud per recuperare informazioni su tutti i tuoi profili di connessione, fai clic qui.
Aggiornare un profilo di connessione
Di seguito è riportata una richiesta di aggiornamento dei campi Nome utente e Password di un profilo di connessione esistente. Se utilizzi il parametro updateMask nella richiesta,
solo questi campi devono essere inclusi nel corpo della richiesta.
REST
Prima di utilizzare i dati della richiesta,
apporta le seguenti sostituzioni:
project-id: l'ID progetto
region: la regione del progetto
connection-profile-id: l'ID profilo di connessione
username: il nome utente del database
password: la password dell'utente del database
Metodo HTTP e URL:
PATCH
Corpo JSON della richiesta:
Per inviare la richiesta, espandi una di queste opzioni:
curl (Linux, macOS o Cloud Shell)
Salva il corpo della richiesta in un file denominato request.json,
quindi esegui il comando seguente:
Per saperne di più sull'utilizzo di gcloud per eliminare il profilo di connessione, fai clic qui.
Eliminare un profilo di connessione e l'istanza AlloyDB associata
Di seguito è riportata una richiesta di eliminazione di un profilo di connessione di destinazione, nonché l'eliminazione in cascata dell'istanza AlloyDB associata.
REST
Prima di utilizzare i dati della richiesta,
apporta le seguenti sostituzioni:
project-id: l'ID progetto
region: la regione del progetto
connection-profile-id: l'ID profilo di connessione
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-01-23 UTC."],[],[]]