In questa sezione imparerai a creare i seguenti profili di connessione:
- Un profilo di connessione a un'origine Oracle, MySQL, SQL Server, PostgreSQL, MongoDB, Salesforce, Salesforce Marketing Cloud, ServiceNow Dataverse e Workday
- Un profilo di connessione ai set di dati di destinazione in BigQuery
- Un profilo di connessione a un bucket di destinazione in Cloud Storage
Creando questi profili di connessione, Datastream può trasferire i dati dal database di origine alla destinazione.
Prima di iniziare
- Assicurati di aver configurato il database di origine per la replica. Per informazioni sui passaggi richiesti per ogni tipo di origine supportato, consulta Configurare le origini.
- Scopri quali passaggi potrebbero essere necessari per configurare la destinazione selezionata. Per saperne di più, consulta Configurare le destinazioni.
Crea un profilo di connessione per il database Oracle
Vai alla pagina Profili di connessione nella console Google Cloud .
Fai clic su CREA PROFILO.
Nella pagina Crea un profilo di connessione, fai clic sul tipo di profilo Oracle.
Utilizza la tabella seguente per compilare i campi della sezione Definisci impostazioni di connessione della pagina Crea profilo Oracle:
Campo Descrizione Nome profilo di connessione Inserisci il nome visualizzato del profilo di connessione al database Oracle di origine. Viene utilizzato nell'elenco dei profili di connessione e quando viene selezionato un profilo di connessione esistente durante la creazione di uno stream. ID profilo di connessione Datastream compila automaticamente questo campo in base al nome del profilo di connessione che inserisci. Puoi mantenere l'ID generato automaticamente o modificarlo. Regione Seleziona la regione in cui è archiviato il profilo di connessione. I profili di connessione, come tutte le risorse, vengono salvati in una regione e uno stream può utilizzare solo i profili di connessione archiviati nella stessa regione dello stream. La selezione della regione non influisce sulla possibilità di Datastream di connettersi all'origine o alla destinazione, ma può influire sulla disponibilità se la regione subisce un tempo di inattività. Nome host o IP Inserisci un nome host o un indirizzo IP che Datastream possa utilizzare per connettersi al database Oracle di origine.
Se utilizzi la connettività privata per comunicare con il database di origine, specifica l'indirizzo IP privato (interno) per il database di origine.
Per altri metodi di connettività, come la lista consentita IP, fornisci l'indirizzo IP pubblico.
Porta Inserisci il numero di porta riservato al database di origine (la porta predefinita è in genere 1521). Nome utente Inserisci il nome utente dell'account per il database di origine (ad esempio ROOT). Questo è l'utente Datastream che hai creato per il database.Per saperne di più sulla creazione di questo utente, consulta Configura il database Oracle di origine.
Seleziona la password di Secret Manager Seleziona questa opzione se vuoi eseguire l'autenticazione con un secret anziché inserire manualmente la password. Se selezioni questa opzione, vengono visualizzati due menu a discesa: - Secret: puoi selezionare un secret dall'elenco (se disponibile), inserirlo manualmente o crearne uno nuovo: Per inserire un secret manualmente:
- Fai clic su Inserisci il secret manualmente. Viene visualizzata la finestra di dialogo Aggiungi un secret tramite ID risorsa.
- Copia e incolla l'identificatore della risorsa secret da Secret Manager. L'ID risorsa secret può avere il seguente formato:
projects/PROJECT_NUMBER/secrets/SECRET_NAME(ultima versione)projects/PROJECT_NUMBER/secrets/SECRET_NAME/versions/VERSION_NUMBER(versione specifica)- Fai clic sul pulsante Aggiungi segreto.
- Fai clic su Crea nuovo secret. Viene aperto il riquadro laterale Dettagli secret.
- In Nome, inserisci un nome per il secret (ad esempio,
my-secret). Il nome di un secret può contenere lettere maiuscole e minuscole, numeri, trattini e trattini bassi. La lunghezza massima consentita per un nome è di 255 caratteri. Il nome che crei viene aggiunto all'identificatore della risorsa secret. - (Facoltativo) Per aggiungere anche una versione del secret durante la creazione del secret iniziale, inserisci un valore per il secret nel campo Valore secret, ad esempio
abcd1234. Il valore del secret può essere in qualsiasi formato, ma non deve superare i 64 KiB. Puoi anche caricare un file di testo contenente il valore del secret utilizzando l'opzione Carica file. - Fai clic sul pulsante Crea secret.
- Versione del secret: inserisci la versione del secret che vuoi utilizzare:
- Quando fornisci l'identificatore della risorsa secret, viene visualizzata la casella di controllo Utilizza l'ultima versione. Puoi selezionarlo per utilizzare la versione più aggiornata della risorsa secret.
- In alternativa, puoi espandere il menu a discesa Versione secret e selezionare la versione dall'elenco, se disponibile.
- Se vuoi utilizzare una versione diversa del segreto, segui questi passaggi:
- Fai clic su Aggiungi nuova versione.
- Nel campo Valore secret, inserisci un valore per il secret. In alternativa, puoi caricare un file contenente il valore del secret.
- Fai clic sul pulsante Aggiungi nuova versione.
Inserisci la password manualmente In alternativa, puoi inserire manualmente la password dell'account per il database di origine.
Identificatore di sistema (SID) Inserisci il servizio che garantisce che il database Oracle di origine sia protetto e monitorato. Per i database Oracle, il servizio di database è in genere ORCL. Per i database modulari, SID è il nome del database modulare. Attivare l'accesso ad ASM per il lettore binario Seleziona questa casella di controllo se memorizzi i log Oracle in Automatic Storage Management (ASM). Questa casella di controllo si applica solo al metodo CDC del lettore di log binari (anteprima). Se lo selezioni, devi compilare i dettagli di connessione per l'istanza ASM, incluso il nome del servizio ASM. L'account utente per la connessione ASM deve disporre del privilegio SYSASM. Per ulteriori informazioni sui metodi CDC disponibili, consulta Utilizzo dei file di redo log del database Oracle.(Facoltativo) Utilizza le etichette per organizzare le risorse Datastream.
- Per creare un'etichetta, fai clic su AGGIUNGI ETICHETTA e poi inserisci la coppia chiave-valore per l'etichetta.
- Per rimuovere l'etichetta, fai clic sull'icona del cestino a destra della riga che la contiene.
Nella sezione Definisci le impostazioni di connessione, fai clic su CONTINUA. La pagina Proteggi la connessione alla tua origine è attiva.
Dal menu Tipo di crittografia, seleziona una delle seguenti opzioni:
Tipo di crittografia Descrizione Nessuno Datastream si connette al database di origine senza crittografia. Solo server Quando Datastream si connette al database di origine, autentica l'origine, assicurandosi di connettersi all'host corretto in modo sicuro. In questo modo si evitano attacchi man-in-the-middle.
Per l'autenticazione solo server, l'origine non autentica Datastream. Per utilizzare l'autenticazione solo server, devi fornire il certificato x509 con codifica PEM dell'autorità di certificazione (CA) che ha firmato il certificato dell'origine. Assicurati di utilizzare un singolo certificato. Datastream non supporta le catene di certificati.
Nella sezione Proteggi la connessione all'origine, fai clic su CONTINUA. La sezione Definisci metodo di connettività della pagina Crea profilo Oracle è attiva.
Dal menu a discesa Metodo di connettività, seleziona un metodo di connettività di rete. Questo metodo definisce la modalità di connessione di Datastream al database di origine. I metodi di connettività di rete attuali includono:
- Inserimento degli IP nella lista consentita: questo metodo funziona configurando il server del database di origine in modo che accetti le connessioni da Datastream. Se selezioni questo metodo di connettività di rete, configura il database di origine in modo da consentire le connessioni in entrata dagli indirizzi IP pubblici di Datastream per la regione specificata per il profilo di connessione.
- Tunnel SSH di forwarding: questo metodo stabilisce una connettività sicura e criptata tra Datastream e il database di origine, utilizzando un tunnel SSH a un server di tunnel o al server di database. Se selezioni questo metodo di connettività di rete, allora:
- Inserisci il nome host o l'indirizzo IP e la porta del server host del tunnel.
- Inserisci il nome utente dell'account per il server host del tunnel.
- Seleziona il metodo di autenticazione per il tunnel SSH. Se selezioni Password come metodo, inserisci la password dell'account per la VM bastion host. Se selezioni Coppia di chiavi privata/pubblica come metodo, fornisci una chiave privata.
- Configura l'host del tunnel in modo da consentire le connessioni in entrata dagli indirizzi IP pubblici di Datastream per la regione specificata per il profilo di connessione.
Connettività privata: questo metodo consente di stabilire una connettività sicura tra Datastream e il database di origine, internamente a Google Cloudo con origini esterne connesse tramite VPN o interconnessione. Questa comunicazione avviene tramite un'interfaccia Private Service Connect o una connessione di peering VPC.
Se selezioni questo metodo di connettività di rete e hai creato una configurazione di connettività privata, selezionala dall'elenco delle configurazioni. Questo tipo di configurazione contiene informazioni che Datastream utilizza per comunicare con il database di origine su una rete privata.
Se non hai creato una configurazione di connettività privata, creane una facendo clic su CREA CONFIGURAZIONE DI CONNETTIVITÀ PRIVATA nella parte inferiore dell'elenco a discesa, quindi esegui gli stessi passaggi descritti in Creazione di una configurazione di connettività privata.
Nella sezione Definisci metodo di connettività, fai clic su CONTINUA. La sezione Testa profilo di connessione della pagina Crea profilo Oracle è attiva.
Fai clic su ESEGUI TEST per verificare che Datastream possa comunicare con l'origine.
Se il test ha esito negativo, indica in quale parte della procedura è stato rilevato un problema. Per la procedura di risoluzione dei problemi, consulta la pagina Diagnostica dei problemi. Puoi apportare le modifiche necessarie e poi eseguire nuovamente il test nella pagina Crea profilo Oracle.
Vai alla parte del flusso in questione per correggere il problema e poi esegui di nuovo il test.
Fai clic su CREA.
Crea un profilo di connessione per il database MySQL
Vai alla pagina Profili di connessione nella console Google Cloud .
Fai clic su CREA PROFILO.
Nella pagina Crea un profilo di connessione, fai clic sul tipo di profilo MySQL.
Utilizza la seguente tabella per compilare i campi della sezione Definisci impostazioni di connessione della pagina Crea profilo MySQL:
Campo Descrizione Nome profilo di connessione Inserisci il nome visualizzato del profilo di connessione al database MySQL di origine. Viene utilizzato nell'elenco dei profili di connessione e quando viene selezionato un profilo di connessione esistente durante la creazione di uno stream. ID profilo di connessione Datastream compila automaticamente questo campo in base al nome del profilo di connessione che inserisci. Puoi mantenere l'ID generato automaticamente o modificarlo. Regione Seleziona la regione in cui è archiviato il profilo di connessione. I profili di connessione, come tutte le risorse, vengono salvati in una regione e uno stream può utilizzare solo i profili di connessione archiviati nella stessa regione dello stream. La selezione della regione non influisce sulla possibilità di Datastream di connettersi all'origine o alla destinazione, ma può influire sulla disponibilità se la regione subisce un tempo di inattività. Nome host o IP Inserisci un nome host o un indirizzo IP che Datastream possa utilizzare per connettersi al database MySQL di origine.
Se utilizzi la connettività privata per comunicare con il database di origine, specifica l'indirizzo IP privato (interno) per il database di origine.
Per altri metodi di connettività, come la lista consentita IP o SSH di forwarding, fornisci l'indirizzo IP pubblico.
Porta Inserisci il numero di porta riservato al database di origine (la porta predefinita è in genere 3306). Nome utente Inserisci il nome utente dell'account per il database di origine (ad esempio
root). Questo è l'utente Datastream che hai creato per il database.Per saperne di più sulla creazione di questo utente, consulta Configura un database MySQL di origine.
Seleziona la password di Secret Manager Seleziona questa opzione se vuoi eseguire l'autenticazione con un secret anziché inserire manualmente la password. Se selezioni questa opzione, vengono visualizzati due menu a discesa: - Secret: puoi selezionare un secret dall'elenco (se disponibile), inserirlo manualmente o crearne uno nuovo: Per inserire un secret manualmente:
- Fai clic su Inserisci il secret manualmente. Viene visualizzata la finestra di dialogo Aggiungi un secret tramite ID risorsa.
- Copia e incolla l'identificatore della risorsa secret da Secret Manager. L'ID risorsa secret può avere il seguente formato:
projects/PROJECT_NUMBER/secrets/SECRET_NAME(ultima versione)projects/PROJECT_NUMBER/secrets/SECRET_NAME/versions/VERSION_NUMBER(versione specifica)- Fai clic su Aggiungi secret.
- Fai clic su Crea nuovo secret. Viene aperto il riquadro laterale Dettagli secret.
- In Nome, inserisci un nome per il secret (ad esempio,
my-secret). Il nome di un secret può contenere lettere maiuscole e minuscole, numeri, trattini e trattini bassi. La lunghezza massima consentita per un nome è di 255 caratteri. Il nome che crei viene aggiunto all'identificatore della risorsa secret. - (Facoltativo) Per aggiungere anche una versione del secret durante la creazione del secret iniziale, inserisci un valore per il secret nel campo Valore secret, ad esempio
abcd1234. Il valore del secret può essere in qualsiasi formato, ma non deve superare i 64 KiB. Puoi anche caricare un file di testo contenente il valore del secret utilizzando l'opzione Carica file. - Fai clic sul pulsante Crea secret.
- Versione del secret: inserisci la versione del secret che vuoi utilizzare:
- Quando fornisci l'identificatore della risorsa secret, viene visualizzata la casella di controllo Utilizza l'ultima versione. Puoi selezionarlo per utilizzare la versione più aggiornata della risorsa secret.
- In alternativa, puoi espandere il menu a discesa Versione secret e selezionare la versione dall'elenco, se disponibile.
- Se vuoi utilizzare una versione diversa del segreto, segui questi passaggi:
- Fai clic su Aggiungi nuova versione.
- Nel campo Valore secret, inserisci un valore per il secret. In alternativa, puoi caricare un file contenente il valore del secret.
- Fai clic sul pulsante Aggiungi nuova versione.
Inserisci la password manualmente In alternativa, puoi inserire manualmente la password dell'account per il database di origine.
(Facoltativo) Utilizza le etichette per organizzare le risorse Datastream.
- Per creare un'etichetta, fai clic su AGGIUNGI ETICHETTA e poi inserisci la coppia chiave-valore per l'etichetta.
- Per rimuovere l'etichetta, fai clic sull'icona del cestino a destra della riga che la contiene.
Nella sezione Definisci le impostazioni di connessione, fai clic su CONTINUA. La pagina Proteggi la connessione alla tua origine è attiva.
Dal menu Tipo di crittografia, seleziona una delle seguenti opzioni:
Tipo di crittografia Descrizione Nessuno Datastream si connette al database di origine senza crittografia. Solo server Quando Datastream si connette al database di origine, autentica l'origine, assicurandosi di connettersi all'host corretto in modo sicuro. In questo modo si evitano attacchi man-in-the-middle.
Per l'autenticazione solo server, l'origine non autentica Datastream. Per utilizzare l'autenticazione solo server, devi fornire il certificato x509 con codifica PEM dell'autorità di certificazione (CA) che ha firmato il certificato dell'origine. Assicurati di utilizzare un singolo certificato. Datastream non supporta le catene di certificati.
Server-client