Connetti allo streaming OCI

Scopri come creare una connessione a OCI Streaming da utilizzare come origine o destinazione con la replica dei dati OCI GoldenGate e Stream Analytics.

Prima di iniziare

Assicurarsi di effettuare quanto riportato di seguito.

Rivedere il modo in cui OCI GoldenGate si connette all'origine e alle destinazioni.
Configurare i criteri necessari per abilitare l'accesso sicuro a vault e segreti, ad esempio l'uso di segreti, i vault e la lettura di bundle di segreti. Per ulteriori informazioni, vedere Criteri consigliati minimi.
Se si utilizzano i principal delle risorse per autenticare l'accesso a OCI Streaming, è necessario:
1. Creare un gruppo dinamico per la distribuzione. Puoi scegliere di autorizzare una singola distribuzione o tutta la distribuzione in un compartimento o in una tenancy. Vedere Scrittura delle regole di corrispondenza per definire i gruppi dinamici.
2. Aggiungere i criteri necessari per il gruppo dinamico
Ottenere il nome utente del pool di flussi:
1. Dal menu di navigazione della console di Oracle Cloud, selezionare Streaming, quindi Pool di flusso.
2. Nella pagina Pool di flussi, selezionare il pool per visualizzarne i dettagli.
3. Nella pagina Dettagli pool di flussi, in Risorse, selezionare Impostazioni connessione Kafka.
4. Copiare il nome utente per le stringhe di connessione SASL.
  
  Nota: se si utilizza il servizio Oracle Identity Cloud, è necessario aggiungere OracleIdentityCloudService al proprio nome utente. Ad esempio, <tenancy-name>/OracleIdentityCloudService/<username>/<streampool-ocid>
5. Creare un token di autorizzazione:
  1. Nell'intestazione globale della console di Oracle Cloud, selezionare Profilo, quindi Impostazioni utente.
  2. Nella pagina Dettagli utente, in Risorse, selezionare Autorizza token, quindi selezionare Genera token.
  3. Nella finestra di dialogo Genera token immettere una descrizione, quindi selezionare Genera token.
  4. Copiare il token di autenticazione dalla finestra di dialogo in una posizione sicura da cui è possibile recuperarlo in un secondo momento, quindi selezionare Chiudi.
Il nome utente e il token di autenticazione del pool di flussi verranno immessi per il nome utente e la password della connessione Stream.

Crea la connessione di origine

Per creare una connessione Streaming OCI di origine:

Nella pagina Panoramica di OCI GoldenGate, selezionare Connessioni.

È inoltre possibile selezionare Crea connessione nella sezione Introduzione e passare al passo 3.
Nella pagina Connessioni selezionare Crea connessione.
Nella pagina Crea connessione, completare i campi come indicato di seguito.
1. In Nome, immettere un nome per la connessione.
2. (Facoltativo) In Descrizione, immettere una descrizione che consenta di distinguere questa connessione dalle altre.
3. (Solo per GoldenGate on Multicloud) Selezionare la propria sottoscrizione, quindi completare i campi riportati di seguito.
  1. Nell'elenco a discesa Compartimento selezionare il compartimento in cui risiede l'ancora risorsa.
  2. Selezionare l'area partner multicloud.
  3. Seleziona la tua zona di disponibilità dei partner. Le opzioni disponibili vengono popolate in base all'area partner multicloud selezionata.
4. In Compartimento selezionare il compartimento in cui creare la connessione.
5. Nell'elenco a discesa Tipo selezionare OCI Streaming.
6. Per i dettagli del pool Stream, è possibile scegliere:
  - Selezionare un pool di flussi dall'elenco a discesa oppure selezionare Modifica compartimento per selezionarne uno in un compartimento diverso.
  - Immettere le informazioni sul pool di flussi per immettere manualmente Host e Porta del server Bootstrap.
    
    Nota: se si immette un IP privato, OCI GoldenGate riscrive l'IP privato nel formato ip-10-0-0-0.ociggsvc.oracle.vcn.com.
7. Per Utente, selezionare la modalità di autenticazione e accesso al pool di flussi:
  - Nome utente e password: immettere il nome utente del pool di flussi copiato dalle impostazioni di connessione SASL nei passi dei prerequisiti precedenti.
  - Usa principal risorsa: esegue l'autenticazione utilizzando il principal risorsa per accedere ad altre risorse OCI.
8. Selezionare il segreto password utente del database. Se si trova in un compartimento diverso, utilizzare l'elenco a discesa per modificare i compartimenti.
  Nota:
  - I segreti sono credenziali quali password, certificati, chiavi SSH o token di autenticazione utilizzati con i servizi OCI. Per creare un segreto, vedere Creazione di un segreto. Assicurarsi di effettuare quanto riportato di seguito.
    - Selezionare Generazione manuale segreto.
    - Incollare le credenziali in Contenuto segreto.
  - Se si preferisce non utilizzare i segreti password, assicurarsi di deselezionare Usa segreti nel vault nella sezione Sicurezza in Opzioni avanzate, nella parte inferiore di questo form.
  - Quando è necessario aggiornare il contenuto del segreto, assicurarsi di:
    - Creare una nuova versione del segreto utilizzando il modello Plain-Text e fornire il contenuto aggiornato. Per ulteriori informazioni, vedere Aggiornamento del contenuto di un segreto.
    - Aggiorna la connessione per cancellare il contenuto segreto inserito nella cache.
9. Espandere l'area Mostra opzioni avanzate È possibile configurare le opzioni riportate di seguito.
  - Sicurezza
    - Deselezionare Usa segreti vault per non utilizzare segreti password per questa connessione. Se l'opzione non viene selezionata:
      - Selezionare Usa chiave di cifratura gestita da Oracle per lasciare a Oracle tutta la gestione delle chiavi di cifratura.
      - Selezionare Usa chiave di cifratura gestita dal cliente per selezionare una chiave di cifratura specifica memorizzata nel vault OCI per cifrare le credenziali di connessione.
  - Connettività di rete
    - Endpoint condiviso per condividere un endpoint con la distribuzione assegnata. È necessario consentire la connettività dall'IP in entrata della distribuzione.
    - Endpoint dedicato, per il traffico di rete attraverso un endpoint dedicato nella subnet assegnata nella tua VCN. È necessario consentire la connettività dagli IP in entrata di questa connessione.
      Nota:
      
      Se un collegamento dedicato rimane non assegnato per sette giorni, il servizio lo converte in una connessione condivisa.
      
      Ulteriori informazioni sulla connettività di Oracle GoldenGate.
  - Impostazioni
    
    Per acquisire da OCI Streaming, creare un file consumer.properties con uno dei deserializzatori o convertitori riportati di seguito, quindi trascinare e rilasciare il file in Proprietà consumer.
    - Proprietà consumer Kafka per JSON deserializer:
```
key.deserializer=org.apache.kafka.common.serialization.ByteArrayDeserializer
value.deserializer=org.apache.kafka.common.serialization.ByteArrayDeserializer
```
    - Proprietà consumer Kafka per il convertitore JSON:
```
key.converter=org.apache.kafka.connect.json.JsonConverter
value.converter=org.apache.kafka.connect.json.JsonConverter
```
    - Proprietà consumatore Kafka per convertitore Avro:
```
key.converter=io.confluent.connect.avro.AvroConverter
value.converter=io.confluent.connect.avro.AvroConverter
```
  - Attributi di sicurezza: aggiungere attributi di sicurezza per controllare l'accesso a questa connessione utilizzando Zero Trust Packet Routing (ZPR).
  - Tag: Aggiunge tag per organizzare le risorse.
Selezionare Crea.

Una volta creata, la connessione viene visualizzata nell'elenco Connessioni. Assicurarsi di assegnare la connessione a una distribuzione per utilizzarla come origine o destinazione in una replica.

Crea la connessione di destinazione

Per creare una connessione OCI Streaming di destinazione, effettuare le operazioni riportate di seguito.

Nella pagina Panoramica di OCI GoldenGate, selezionare Connessioni.

È inoltre possibile selezionare Crea connessione nella sezione Introduzione e passare al passo 3.
Nella pagina Connessioni selezionare Crea connessione.
Nella pagina Crea connessione, completare i campi come indicato di seguito.
1. In Nome, immettere un nome per la connessione.
2. (Facoltativo) In Descrizione, immettere una descrizione che consenta di distinguere questa connessione dalle altre.
3. (Solo per GoldenGate on Multicloud) Selezionare la propria sottoscrizione, quindi completare i campi riportati di seguito.
  1. Nell'elenco a discesa Compartimento selezionare il compartimento in cui risiede l'ancora risorsa.
  2. Selezionare l'area partner multicloud.
  3. Seleziona la tua zona di disponibilità dei partner. Le opzioni disponibili vengono popolate in base all'area partner multicloud selezionata.
4. In Compartimento selezionare il compartimento in cui creare la connessione.
5. Nell'elenco a discesa Tipo selezionare OCI Streaming.
6. Per i dettagli del pool Stream, è possibile scegliere:
  - Selezionare un pool di flussi
    1. Selezionare un pool di flussi dall'elenco a discesa oppure selezionare Modifica compartimento per selezionarne uno in un compartimento diverso.
  - Immettere le informazioni sul pool di flussi per immettere manualmente le informazioni sul pool di flussi.
    1. Immettere Host e Porta del server Bootstrap.
    Nota: se si immette un IP privato, OCI GoldenGate riscrive l'IP privato nel formato ip-10-0-0-0.ociggsvc.oracle.vcn.com.
7. Per Utente, selezionare la modalità di autenticazione e accesso al pool di flussi:
  - Nome utente e password: immettere il nome utente del pool di flussi copiato dalle impostazioni di connessione SASL nei passi dei prerequisiti precedenti.
  - Usa principal risorsa: esegue l'autenticazione utilizzando il principal risorsa per accedere ad altre risorse OCI.
8. Selezionare il segreto password utente del database. Se si trova in un compartimento diverso, utilizzare l'elenco a discesa per modificare i compartimenti.
  Nota:
  - I segreti sono credenziali quali password, certificati, chiavi SSH o token di autenticazione utilizzati con i servizi OCI. Per creare un segreto, vedere Creazione di un segreto. Assicurarsi di effettuare quanto riportato di seguito.
    - Selezionare Generazione manuale segreto.
    - Incollare le credenziali in Contenuto segreto.
  - Se si preferisce non utilizzare i segreti password, assicurarsi di deselezionare Usa segreti nel vault nella sezione Sicurezza in Opzioni avanzate, nella parte inferiore di questo form.
  - Quando è necessario aggiornare il contenuto del segreto, assicurarsi di:
    - Creare una nuova versione del segreto utilizzando il modello Plain-Text e fornire il contenuto aggiornato. Per ulteriori informazioni, vedere Aggiornamento del contenuto di un segreto.
    - Aggiorna la connessione per cancellare il contenuto segreto inserito nella cache.
9. Espandere l'area Mostra opzioni avanzate È possibile configurare le opzioni riportate di seguito.
  - Sicurezza
    - Deselezionare Usa segreti vault per non utilizzare segreti password per questa connessione. Se l'opzione non viene selezionata:
      - Selezionare Usa chiave di cifratura gestita da Oracle per lasciare a Oracle tutta la gestione delle chiavi di cifratura.
      - Selezionare Usa chiave di cifratura gestita dal cliente per selezionare una chiave di cifratura specifica memorizzata nel vault OCI per cifrare le credenziali di connessione.
  - Connettività di rete
    - Endpoint condiviso per condividere un endpoint con la distribuzione assegnata. È necessario consentire la connettività dall'IP in entrata della distribuzione.
    - Endpoint dedicato, per il traffico di rete attraverso un endpoint dedicato nella subnet assegnata nella tua VCN. È necessario consentire la connettività dagli IP in entrata di questa connessione.
      Nota:
      
      Se un collegamento dedicato rimane non assegnato per sette giorni, il servizio lo converte in una connessione condivisa.
      
      Ulteriori informazioni sulla connettività di Oracle GoldenGate.
  - Impostazioni: per utilizzare la compressione Snappy nella replica Kafka, trascinare o selezionare Proprietà del producer e modificare le impostazioni di replica come descritto in Utilizzo della replica Kafka Compression OCI GoldenGate (Confluent).
  - Attributi di sicurezza: aggiungere attributi di sicurezza per controllare l'accesso a questa connessione utilizzando Zero Trust Packet Routing (ZPR).
  - Tag: Aggiunge tag per organizzare le risorse.
Selezionare Crea.

Una volta creata, la connessione viene visualizzata nell'elenco Connessioni. Assicurarsi di assegnare la connessione a una distribuzione per utilizzarla come origine o destinazione in una replica.

Connetti allo streaming OCI

Prima di iniziare

Crea la connessione di origine

Crea la connessione di destinazione

Passi successivi