Conectar-se ao SAP Datasphere

Como administrador do BigQuery, é possível criar uma conexão para acessar dados do SAP Datasphere. Essa conexão permite que os analistas de dados consultem dados no SAP Datasphere.

Antes de começar

1. Ative a API BigQuery Connection.

   Ativar a API

2. Crie um usuário de banco de dados do SAP Datasphere. Anote o nome de usuário, a senha, o nome do host e a porta para conexão do BigQuery.

3. Configure seu locatário do SAP Datasphere para aceitar tráfego dos endereços IP selecionados fazendo uma destas ações:

   • Adicione todos os intervalos de endereços IP do Google à lista de permissões "IPs confiáveis" no SAP Datasphere.
   • Abra o locatário do SAP Datasphere para conexões de todos os endereços IP adicionando 0.0.0.0/0 à lista de permissões.

   • Configure sua conexão com anexos de rede para que o BigQuery abra a conexão de um endereço IP estático.

   Para mais informações sobre como configurar seu locatário do SAP Datasphere, consulte Adicionar o endereço IP à lista de permissões de IP.

Funções exigidas

Para receber as permissões necessárias para se conectar ao SAP Datasphere, peça ao administrador para conceder a você os papéis do IAM a seguir:

• Para criar uma conexão: Administrador de conexão do BigQuery (roles/bigquery.connectionAdmin) no projeto
• Para configurar anexos de rede: Administrador do Compute (roles/compute.admin) no projeto

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

Configurar um anexo de rede

Como as consultas federadas estabelecem uma conexão direta com seu banco de dados usando a API BigQuery Connection, você precisa permitir o tráfego de Google Cloud para seu mecanismo de banco de dados. Para aumentar a segurança, você só devem permitir o tráfego proveniente de suas consultas do BigQuery. Essa restrição de tráfego pode ser alcançada de duas maneiras:

• Ao definir um endereço IP estático usado por um e adicionando-a às regras de firewall da fonte de dados externa.
• Ao criar uma VPN entre o BigQuery e seus infraestrutura e usá-la nas consultas.

Ambas as técnicas são compatíveis com o uso de anexos de rede.

Limitações

As conexões com anexos de rede estão sujeitas às seguintes limitações:

• Para regiões padrão, os anexos de rede precisam estar localizados na mesma região como a conexão. Para conexões na multirregião US, a rede o anexo precisa estar localizado na região us-central1. Para conexões no EU multirregional, o anexo de rede precisa estar localizado no europe-west4 região.
• Não é possível editar o anexo de rede depois de criá-lo. Para mudar sua configuração, recrie o anexo de rede.
• Não é possível excluir anexos de rede, a menos que o BigQuery exclua os recursos alocados. Para iniciar o processo de exclusão, entre em contato com o suporte do BigQuery.

Criar um anexo de rede

Ao criar uma conexão para a federação de consultas, você pode especificar um anexo de rede opcional que fornece conectividade à rede do seu banco de dados. É possível criar um anexo de rede definindo um endereço IP estático ou criando uma VPN. Para qualquer uma das opções, faça o seguinte:

1. Se você ainda não tiver uma, criar uma rede e sub-rede VPC.

2. Dependendo do método de roteamento escolhido, faça o seguinte:

   • Para um endereço IP estático: Crie um gateway do Cloud NAT com um endereço IP estático, usando a rede, a região e a sub-rede que você criou.
   • Para uma VPN: Crie uma VPN conectada à sua rede privada.

3. Criar um anexo de rede usando a rede, a região e a sub-rede que você criou.

4. Opcional: dependendo das políticas de segurança da sua organização, talvez você precise configurar o firewall do Google Cloud para permitir a saída Como criar uma regra de firewall com as seguintes configurações:

   • Defina Destinos como Todas as instâncias na rede.
   • Defina Intervalos IPv4 de destino como todo o intervalo de endereços IP.
   • Defina Protocolos e portas especificados como a porta usada pelo seu no seu banco de dados.

5. Configurar o firewall interno para permitir a entrada do endereço IP estático que você criou. Esse processo varia de acordo com a fonte de dados.

Conectar o BigQuery ao SAP Datasphere

É possível conectar o BigQuery ao SAP Datasphere no console Google Cloud ou na ferramenta de linha de comando bq.

  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

Observação:se você configurou sua conexão para usar um anexo de rede, execute uma consulta federada inicial para sincronizar seu projeto com o anexo de rede antes que ele fique totalmente ativo.

Compartilhar conexões com os usuários

Você pode conceder os seguintes papéis para permitir que os usuários consultem dados e gerenciem conexões:

• roles/bigquery.connectionUser: permite aos usuários usar conexões para se conectar a fontes de dados externas e executar consultas nelas.

• roles/bigquery.connectionAdmin: permite que os usuários gerenciem conexões.

Para mais informações sobre os papéis e as permissões do IAM no BigQuery, consulte Papéis e permissões predefinidos.

Selecione uma das seguintes opções:

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:example-analyst-group@google.com")
              .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");
    }
  }
}

Preços

• Os preços padrão de consultas federadas são aplicáveis.
• O uso da VPC está sujeito aos preços da nuvem privada virtual.
• O uso do Cloud VPN está sujeito aos preços do Cloud VPN.
• O uso do Cloud NAT está sujeito aos preços do Cloud NAT.

A seguir

• Saiba sobre diferentes tipos de conexão.
• Saiba mais sobre como gerenciar conexões.
• Saiba mais sobre consultas federadas.
• Saiba como consultar dados do SAP Datasphere.