Connettersi a SAP Datasphere

Anteprima

Questo prodotto o funzionalità sono soggetti ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Nota: per ricevere assistenza o fornire un feedback su questa funzionalità di anteprima, contatta [e-mail].

In qualità di amministratore di BigQuery, puoi creare una connessione per accedere ai dati di SAP Datasphere. Questa connessione consente agli analisti di dati di eseguire query sui dati in SAP Datasphere.

Prima di iniziare

1. Abilita l'API BigQuery Connection.

   Abilitare l'API

2. Crea un utente del database SAP Datasphere. Prendi nota del nome utente, della password, del nome host e della porta a cui BigQuery deve connettersi.

3. Configura il tenant SAP Datasphere in modo che accetti il traffico dagli indirizzi IP selezionati eseguendo una delle seguenti operazioni:

   • Aggiungi tutti gli intervalli di indirizzi IP di Google a la lista consentita "IP attendibili" in SAP Datasphere.
   • Apri il tenant SAP Datasphere alle connessioni da tutti gli indirizzi IP aggiungendo 0.0.0.0/0 alla lista consentita.

   • Configura la connessione con i collegamenti di rete in modo che BigQuery apra la connessione da un indirizzo IP statico

     Nota: se il collegamento di rete e la VM configurati si trovano in regioni diverse, potrebbe verificarsi uno spostamento dei dati tra regioni quando utilizzi questa connessione per eseguire query sui dati di SAP Datasphere.

   Per saperne di più sulla configurazione del tenant SAP Datasphere, consulta Aggiungere un indirizzo IP alla lista consentita IP.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per connetterti a SAP Datasphere, chiedi all'amministratore di concederti il ruolo IAM Amministratore connessione BigQuery (roles/bigquery.connectionAdmin) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Connettere BigQuery a SAP Datasphere

Puoi connettere BigQuery a SAP Datasphere nella Google Cloud console o nello strumento a riga di comando bq.

Console

1. Nella Google Cloud console, vai alla pagina BigQuery.

   Vai a BigQuery

2. Nel riquadro Spazio di esplorazione, fai clic su Aggiungi dati.

   Viene visualizzata la finestra di dialogo Aggiungi dati.

3. Nel riquadro Filtra per, nella sezione Tipo di origine dati, seleziona Database.

   In alternativa, nel campo Cerca origini dati puoi inserire SAP HANA.

4. Nella sezione Origini dati in primo piano, fai clic su SAP HANA.

5. Fai clic sulla scheda della soluzione SAP HANA: federazione BigQuery.

6. Nella finestra di dialogo Origine dati esterna, procedi nel seguente modo:

   • In Tipo di connessione, seleziona SAP HANA.
   • In ID connessione, inserisci un ID connessione per identificare questa connessione.
   • In Tipo di località, specifica una regione del set di dati BigQuery da combinare con i dati di SAP Datasphere. Le query che utilizzano questa connessione devono essere eseguite da questa regione.
   • (Facoltativo) In Nome visualizzato, inserisci un nome intuitivo per la connessione, ad esempio My connection resource. Il nome visualizzato può essere qualsiasi valore che ti aiuti a identificare la risorsa di connessione se devi modificarla in un secondo momento.
   • (Facoltativo) In Descrizione, inserisci una descrizione per questa risorsa di connessione.
   • In Crittografia, seleziona Google-managed encryption key o Chiave di crittografia gestita dal cliente (CMEK). L'utilizzo di una CMEK è facoltativo.
   • In Host:porta: inserisci l'host e la porta dell'istanza del database SAP, come mostrato in Dettagli utente database nella console web SAP Datasphere, nel formato HOST:PORT.
   • (Facoltativo) In Collegamento di rete, inserisci un percorso al collegamento di rete che definisce la configurazione di rete utilizzata per stabilire una connessione a SAP Datasphere.
   • In Nome utente, inserisci il nome utente del database da Dettagli utente database nella console web SAP Datasphere. Ad esempio, MY_SPACE#BIGQUERY.
   • In Password , inserisci la password dell'utente del database.

7. Fai clic su Crea connessione.

bq

Inserisci il bq mk comando con i seguenti flag:

  bq mk \
  --connection \
  --location=LOCATION \
  --project_id=PROJECT_ID \
  --connector_configuration '{
    "connector_id": "saphana",
    "endpoint": {
      "host_port": "HOST_PORT"
    },
    "authentication": {
      "username_password": {
        "username": "USERNAME",
        "password": {
          "plaintext": "PASSWORD"
        }
      }
    },
    "network": {
      "private_service_connect": {
        "network_attachment": "NETWORK_ATTACHMENT"
      }
    }
  }' \
  CONNECTION_ID

Sostituisci quanto segue:

• LOCATION: specifica una regione del set di dati BigQuery da combinare con i dati di SAP Datasphere. Le query che utilizzano questa connessione devono essere eseguite da questa regione.
• PROJECT_ID: inserisci il tuo Google Cloud ID progetto.
• HOST_PORT: inserisci l'host e la porta dell'istanza del database SAP, come mostrato in Dettagli utente database nella console web SAP Datasphere, nel formato HOST:PORT.
• NETWORK_ATTACHMENT (facoltativo): inserisci il collegamento di rete nel formato projects/{project}/regions/{region}/networkAttachments/{networkattachment}. Con questo campo, puoi configurare la connessione SAP Datasphere in modo che BigQuery apra la connessione da un indirizzo IP statico.
• USERNAME: inserisci il nome utente del database da Dettagli utente database nella console web SAP Datasphere. Ad esempio, MY_SPACE#BIGQUERY.
• PASSWORD: inserisci la password dell'utente del database.
• CONNECTION_ID: inserisci un ID connessione per identificare questa connessione.

Flag facoltativo:

• --kms_key_name: una chiave di crittografia gestita dal cliente. Se omesso, le credenziali sono protette per impostazione predefinita Google-owned and Google-managed encryption key.

Condividere le connessioni con gli utenti

Puoi concedere i seguenti ruoli per consentire agli utenti di eseguire query sui dati e gestire le connessioni:

• roles/bigquery.connectionUser: consente agli utenti di utilizzare le connessioni per connettersi a origini dati esterne ed eseguire query su di esse.

• roles/bigquery.connectionAdmin: consente agli utenti di gestire le connessioni.

Per saperne di più sui ruoli e sulle autorizzazioni IAM in BigQuery, consulta Ruoli e autorizzazioni predefiniti.

Seleziona una delle seguenti opzioni:

Console

1. Vai alla pagina BigQuery.

   Vai a BigQuery

   Le connessioni sono elencate nel progetto, in un gruppo denominato Connessioni.

2. Nel riquadro a sinistra, fai clic su Spazio di esplorazione:

   

   Se non vedi il riquadro a sinistra, fai clic su Espandi riquadro a sinistra per aprirlo.

3. Fai clic sul progetto, su Connessioni e poi seleziona una connessione.

4. Nel riquadro Dettagli, fai clic su Condividi per condividere una connessione. Quindi:

   1. Nella finestra di dialogo Autorizzazioni connessione, condividi la connessione con altre entità aggiungendo o modificando le entità.

   2. Fai clic su Salva.

bq

Non puoi condividere una connessione con lo strumento a riga di comando bq. Per condividere una connessione, utilizza la Google Cloud console o il metodo dell'API BigQuery Connections per condividere una connessione.

API

Utilizza il projects.locations.connections.setIAM metodo nella sezione di riferimento dell'API REST BigQuery Connections e fornisci un'istanza della risorsa policy.

Java

Prima di provare questo esempio, segui le istruzioni di configurazione Java nella guida rapida di BigQuery per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell' API Java di BigQuery.

Per eseguire l'autenticazione in BigQuery, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configura l'autenticazione per le librerie client.

import com.google.api.resourcenames.ResourceName;
import com.google.cloud.bigquery.connection.v1.ConnectionName;
import com.google.cloud.bigqueryconnection.v1.ConnectionServiceClient;
import com.google.iam.v1.Binding;
import com.google.iam.v1.Policy;
import com.google.iam.v1.SetIamPolicyRequest;
import java.io.IOException;

// Sample to share connections
public class ShareConnection {

  public static void main(String[] args) throws IOException {
    // TODO(developer): Replace these variables before running the sample.
    String projectId = "MY_PROJECT_ID";
    String location = "MY_LOCATION";
    String connectionId = "MY_CONNECTION_ID";
    shareConnection(projectId, location, connectionId);
  }

  static void shareConnection(String projectId, String location, String connectionId)
      throws IOException {
    try (ConnectionServiceClient client = ConnectionServiceClient.create()) {
      ResourceName resource = ConnectionName.of(projectId, location, connectionId);
      Binding binding =
          Binding.newBuilder()
              .addMembers("group:[e-mail]")
              .setRole("roles/bigquery.connectionUser")
              .build();
      Policy policy = Policy.newBuilder().addBindings(binding).build();
      SetIamPolicyRequest request =
          SetIamPolicyRequest.newBuilder()
              .setResource(resource.toString())
              .setPolicy(policy)
              .build();
      client.setIamPolicy(request);
      System.out.println("Connection shared successfully");
    }
  }
}

Passaggi successivi

• Scopri di più sui diversi tipi di connessione.
• Scopri di più sulla gestione delle connessioni.
• Scopri di più sulle query federate.
• Scopri come eseguire query sui dati di SAP Datasphere.