Instalar e configurar o BigQuery Connector para SAP em um host fora do Google Cloud

Este guia mostra como instalar e configurar a versão 2.8 (mais recente) do BigQuery Connector para SAP em um SAP LT Replication Server em execução em um host no local, em outro provedor de nuvem ou em outro ambiente fora do Google Cloud.

Se a caixa do SAP LT Replication Server for gerenciada pela SAP com o programa SAP RISE, siga este guia para instalar e configurar o BigQuery Connector para SAP.

Neste guia, você verá como preparar o BigQuery, o SAP Landscape Transformation Replication Server (SAP LT Replication Server) e o BigQuery Connector para SAP para replicar dados do SAP de aplicativos SAP diretamente e com segurança para o BigQuery em tempo real.

Este guia é destinado a administradores SAP, administradores do Google Cloud e outros profissionais de segurança e dados do SAP e Google Cloud.

Pré-requisitos

Antes de instalar o BigQuery Connector para SAP, verifique se os seguintes pré-requisitos foram atendidos:

• Você leu o guia de planejamento do conector do BigQuery para SAP. No guia de planejamento, você verá as opções do BigQuery Connector para SAP, considerações de desempenho, mapeamento de campo e outras informações necessárias para a configuração ideal do BigQuery Connector para SAP.

• Se você ainda não tem um projeto do Google Cloud, crie um:

  Acessar o seletor de projetos

• O faturamento está ativado para o projeto. Saiba como confirmar se o faturamento está ativado para o projeto. É necessário ter uma conta de faturamento para o BigQuery, a API de streaming do BigQuery e para fazer o download do BigQuery Connector para SAP.

• A manutenção do software SAP instalado é atual, e as versões de todo o software SAP são compatíveis entre si, conforme documentado na Matriz de disponibilidade de produtos SAP (em inglês).

• As versões do software SAP que você está usando são compatíveis com o conector do BigQuery para SAP, conforme documentado em Requisitos de software.

• você tem as licenças SAP necessárias para replicar dados para qualquer destino por meio do SDK do SAP LT Replication Server; Para mais informações sobre licenciamento da SAP, consulte a Nota SAP 2707835.

• O servidor de replicação do SAP LT está instalado. Para mais informações sobre como instalar o SAP LT Replication Server, consulte a documentação do SAP (em inglês).

• A conexão RFC ou de banco de dados entre o SAP LT Replication Server e o sistema de origem está configurada. Se necessário, teste as conexões RFC usando a transação SAP SM59. Teste as conexões de banco de dados usando a transação SAP DBACOCKPIT.

Visão geral do processo de instalação e configuração

A tabela a seguir mostra os procedimentos abordados neste guia e os papéis que normalmente os executam.

Observação: dependendo da sua versão do SAP LT Replication Server, alguns dos detalhes nos procedimentos documentados neste guia podem ser diferentes dos detalhes que o que você vê ao executar as etapas.

Procedimento	Papel
Se necessário, após validar todas as licenças apropriadas da SAP, siga as instruções da SAP para instalar um SAP Landscape Transformation Replication Server.	Administrador do SAP.
Se necessário, instale o complemento da interface do usuário (IU) para SAP NetWeaver. Para mais informações, consulte os requisitos do software SAP.	Administrador do SAP.
Estabeleça uma conexão de rede entre o sistema SAP e o Google Cloud.	Administrador de rede.
Ative as APIs do Google Cloud necessárias.	Administrador do Google Cloud
Ativar o acesso particular às APIs do Google Cloud.	Administrador de rede do Google Cloud.
crie um conjunto de dados do BigQuery;	Administrador ou engenheiro de dados do Google Cloud.
Configurar a autenticação e autorização do Google Cloud.	Administrador de segurança do Google Cloud.
Faça o download do pacote de instalação do BigQuery Connector para SAP.	Titular da conta de faturamento do Google Cloud.
Instale o conector do BigQuery para SAP.	Administrador do SAP.
Crie papéis e permissões do SAP para conector do BigQuery para SAP.	Administrador do SAP.
Configurar replicação	engenheiros ou administradores de dados
Replicação de teste.	Engenheiros ou administradores de dados
Valide a replicação.	Engenheiros ou administradores de dados

Estabelecer uma conexão de rede com o Google Cloud

Se sua carga de trabalho da SAP não estiver sendo executada no Google Cloud, você ou um administrador de rede precisará estabelecer uma conexão segura, com alta largura de banda e baixa latência com o Google Cloud.

Você tem estas duas opções de conexão:

• Cloud Interconnect (recomendado)
• Cloud VPN

Para configurar uma conexão, siga as instruções fornecidas pelo serviço de conexão do Google Cloud selecionado.

Cada serviço de conexão tem instruções diferentes para os diferentes cenários. Portanto, leia a documentação do serviço e siga as instruções adequadas ao seu caso.

Ativar as APIs do Google Cloud necessárias

Antes que o BigQuery Connector para SAP possa acessar o BigQuery, você precisa ativar as seguintes APIs do Google Cloud:

• API BigQuery
• API IAM Service Account Credentials

Para informações sobre como ativar as APIs do Google Cloud, consulte Como ativar APIs.

Ativar o acesso particular às APIs do Google Cloud

Se a carga de trabalho da SAP não estiver em execução no Google Cloud, depois de estabelecer uma conexão de rede com o Google Cloud, você precisará ativar o acesso particular às APIs do Google Cloud.

Para ativar o acesso privado à API, consulte Como configurar o Acesso privado do Google para hosts locais.

Criar um conjunto de dados do BigQuery

Antes de testar a autenticação e autorização do Google Cloud para o BigQuery ou criar tabelas de destino do BigQuery, você ou um engenheiro de dados ou administrador precisa criar um conjunto de dados do BigQuery.

Para criar um conjunto de dados do BigQuery, sua conta de usuário precisa ter as permissões de IAM adequadas para o BigQuery. Para mais informações, consulte Permissões necessárias.

1. No Console do Google Cloud, acesse a página do BigQuery:

   Ir para o BigQuery

2. Ao lado do ID do projeto, clique no ícone Ver ações, e, em seguida, clique em Criar conjunto de dados.

   

3. No campo ID do conjunto de dados, insira um nome exclusivo. Para mais informações, consulte Nomear conjuntos de dados.

Depois de configurar a autenticação e a autorização do Google Cloud, teste o acesso ao Google Cloud recuperando informações sobre esse conjunto de dados.

Para mais informações sobre como criar conjuntos de dados do BigQuery, consulte Como criar conjuntos de dados.

Configurar a autenticação e a autorização do Google Cloud

Para autenticação no Google Cloud e autorização a fim de acessar o BigQuery, um administrador de segurança do Google Cloud e um administrador do SAP precisam configurar a autenticação usando JSON Web Tokens (JWT) assinados pelo Google Cloud.

As etapas de configuração de nível alto são as seguintes:

• Crie uma conta de serviço para autenticação com base em JWT no Google Cloud.
  • Conceda à conta de serviço o papel do IAM necessário para criar tokens.
  • Crie uma chave de conta de serviço (P12).
  • Ative a assinatura JWT para a conta de serviço no host do SAP LT Replication Server.
• Defina as configurações de segurança do Google Cloud no host do SAP LT Replication Server.
  • Crie um novo aplicativo SSF e ative o nó STRUST para o aplicativo SSF.
  • Importe a chave da conta de serviço para o STRUST.
• Crie outra conta de serviço para autorização de acesso ao BigQuery.
  • Conceda à conta de serviço os papéis do IAM necessários para acessar o BigQuery.
  • Adicione a conta de serviço do BigQuery Connector para SAP como uma principal no projeto do BigQuery.
  • Configure certificados SSL e HTTPS.
• Crie configurações do ABAP.
  • Crie novos destinos de RFC.
  • Especificar as configurações de acesso em /GOOG/CLIENT_KEY.
  • Especifique destinos de RFC em /GOOG/SERVIC_MAP.

Criar uma conta de serviço para recuperação de tokens baseada em JWT

Criar uma conta de serviço

Para a autenticação baseada em JWT para o Google Cloud, o BigQuery Connector para SAP precisa de uma conta de serviço do IAM.

Para criar uma conta de serviço para recuperação de token baseado em JWT, siga estas etapas:

1. No console do Google Cloud, acesse a página Contas de serviço do IAM e do administrador.

   Acessar Contas de serviço

2. Se solicitado, selecione o projeto do Google Cloud.

3. Clique em Criar conta de serviço.

4. Especifique um nome para a conta de serviço e, opcionalmente, uma descrição.

5. Clique em Criar e continuar.

6. No painel Conceder a essa conta de serviço acesso ao projeto, selecione o papel Criador do token da conta de serviço.

7. Clique em Continuar.

8. Conceda aos outros usuários acesso à conta de serviço, conforme adequado.

9. Clique em Concluído. A conta de serviço aparece na lista de contas de serviço do projeto do Google Cloud.

Criar uma chave de conta de serviço

É necessário criar uma chave de conta de serviço P12 para a conta de serviço usada na recuperação de tokens baseados em JWT.

Observação: as chaves de conta de serviço poderão causar problemas de segurança se não forem gerenciadas corretamente. Você é responsável pela segurança da chave privada e por outras operações descritas em Práticas recomendadas para gerenciar chaves de contas de serviço. Se não for possível criar uma chave de conta de serviço, a criação pode ser desativada para sua organização. Para mais informações, consulte Gerenciar recursos da organização com segurança por padrão.

Para criar uma chave da conta de serviço, conclua estas etapas:

1. No Console do Google Cloud, acesse a página Contas de serviço do IAM e do administrador.

   Acessar Contas de serviço

2. Selecione seu projeto do Google Cloud.

3. Clique no endereço de e-mail da conta de serviço que você criou para a recuperação de token baseado em JWT na seção anterior, Criar uma conta de serviço.

4. No nome da conta de serviço, clique na guia Chaves.

5. Clique no menu suspenso Adicionar chave e selecione Criar nova chave para criar uma chave de conta de serviço.

6. Aceite P12 como o tipo de chave e clique em Criar.

   Uma chave privada é salva em seu computador.

7. Anote a senha do arquivo da chave privada notasecret.

   Forneça a chave privada e a senha ao administrador SAP para importar a chave privada para STRUST, conforme descrito em Importar a chave da conta de serviço para STRUST.

Ativar a assinatura JWT para a conta de serviço no host do SAP LT Replication Server.

Para ativar a assinatura JWT para a conta de serviço que você criou para a recuperação de token baseada em JWT, é necessário adicionar o parâmetro JWT_SERVC_ACCT à tabela /GOOG/BQ_PARAM e configurar a conta de serviço.

Para ativar a assinatura JWT para uma conta de serviço, siga estas etapas:

1. Na GUI do SAP, insira a transação /GOOG/SLT_SETTINGS precedida por /n:

   /n/GOOG/SLT_SETTINGS

2. No menu suspenso Tabela de configurações na tela de inicialização da transação /GOOG/SLT_SETTINGS, selecione Parâmetros.

3. Clique no ícone Executar. A tela Manutenção de configurações do BigQuery: parâmetros é exibida.

4. Clique no ícone Inserir linha.

5. Na linha exibida, especifique as seguintes configurações:

   1. No campo Nome do parâmetro, insira JWT_SERVC_ACCT. A descrição do parâmetro é preenchida automaticamente.
   2. No campo Valor do parâmetro, insira o endereço de e-mail da conta de serviço que você criou para a recuperação de token baseado em JWT na seção anterior, Criar uma conta de serviço

6. Clique em Save.

   Os atributos são armazenados como um registro na tabela de configuração /GOOG/BQ_PARAM e os campos Alterado por, Alterado em e Alterado às são preenchidos automaticamente.

Definir as configurações de segurança do Google Cloud no host do SAP LT Replication Server

Criar um novo aplicativo de armazenamento seguro e encaminhamento (SSF, na sigla em inglês)

Na tabela SSFAPPLIC, a entrada ZG_JWT é importada como parte do transporte do BigQuery Connector para SAP. Caso a entrada ZG_JWT não seja importada, crie uma nova com o nome ZG_JWT usando a transação SE16.

Para criar uma nova entrada na tabela SSFAPPLIC, siga estas etapas:

1. Na GUI do SAP, insira o código da transação SE16.
2. No campo Nome da tabela, insira SSFAPPLIC e crie uma nova entrada.
3. No campo APPLIC, digite ZG_JWT.
4. Com exceção dos campos B_INCCERTS, B_DETACHED, B_ASKPWD e B_DISTRIB, selecione todos os outros campos.
5. No campo DESCRIPT, insira JWT Signature for GCP.

6. Salve a nova entrada.

   Essa entrada se torna um novo nó na transação STRUST, em que você importa a chave da conta de serviço.

Ativar o nó STRUST

Use a transação SSFA para ativar o nó STRUST para JWT Signature for GCP.

Para ativar o nó STRUST, siga estas etapas:

1. Na GUI do SAP, insira a transação SSFA.
2. Clique em Novas entradas.

3. Na lista suspensa Application SSF, selecione JWT Signature for GCP. É a nova entrada que você criou na tabela SSFAPPLIC.

   A captura de tela a seguir mostra os parâmetros SSF específicos do aplicativo que são preenchidos automaticamente pelo SAP.

   

4. Salve a nova entrada.

   Um novo nó SSF JWT Signature for GCP está ativado na transação STRUST. Agora você importa a chave da conta de serviço para esse nó.

Importar a chave da conta de serviço para o STRUST

Para importar a chave da conta de serviço para STRUST, siga estas etapas:

1. Na GUI do SAP, insira o código da transação STRUST.

   Verifique se o novo nó na transação STRUST é SSF JWT Signature for GCP.

2. Importe o arquivo de chave privada:

   1. Selecione PSE > Importar na barra de menus.
   2. Dependendo do tipo do sistema de origem, selecione a chave privada adequada:
      • S4/HANA
        1. Selecione a chave privada P12.
        2. Digite a senha do arquivo notasecret e clique em OK.
      • ECC
        1. Selecione a chave privada PSE. É necessário converter a chave privada P12 que você salvou anteriormente em uma chave privada PSE. Para mais informações sobre como converter uma chave P12 em uma chave PSE, consulte Converter chave P12 em chave PSE.
        2. Insira o PIN do arquivo que você criou durante a conversão da chave privada de P12 para PSE e clique em OK.

3. Selecione PSE > Salvar como.

4. Selecione o botão de opção Aplicativo SSF e, no campo correspondente, selecione o novo nó do aplicativo SSF criado em Criar um aplicativo de armazenamento de segurança e encaminhamento (SSF, na sigla em inglês).

5. Salve a nova entrada.

   A chave de serviço está anexada ao nó do aplicativo SSF SSF JWT Signature for GCP.

Converter a chave privada P12 em uma chave PS

Se o sistema de origem é o SAP NetWeaver 7.0x (SAP ECC), é necessário converter a chave P12 em uma chave PSE.

Para converter a chave P12 em uma chave PSE, siga estas etapas:

1. Acesse o caminho:

   /usr/sap/SID/SYS/exe/run/

   Substitua SID pelo ID do sistema SAP.

2. Execute o comando a seguir depois de substituir os marcadores:

   sapgenpse import_p12 -p PSE_PATH_AND_FILE_NAME P12_PATH_AND_FILE_NAME.p12

   Substitua:

   • PSE_PATH_AND_FILE_NAME: especifique o caminho e o nome do arquivo PSE.
   • P12_PATH_AND_FILE_NAME: especifique o caminho e o nome do arquivo da chave P12.

3. Digite a senha do arquivo de chave privada P12, notasecret.

4. Crie um novo PIN para a chave privada PSE e insira o PIN novamente.

5. Anote o PIN. Ele será necessário ao importar o arquivo da chave privada do PSE para STRUST.

Para informações da SAP sobre como converter uma chave P12 em uma chave P12, consulte o seguinte:

• Nota SAP 2148457 - Como converter o par de chaves de um contêiner PKCS#12 / PFX em um arquivo PSE
• Nota SAP 2976401 – Erro "import_p12: erro ao criar o PSE" durante a conversão do par de chaves do contêiner PKCS#12 / PFX em um arquivo PSE

Criar uma conta de serviço para autorizar o acesso ao BigQuery

Criar uma conta de serviço

O conector do BigQuery para SAP precisa de uma conta de serviço do IAM para autenticação e autorização para acessar o BigQuery.

Essa conta de serviço precisa ser um principal no projeto do Google Cloud que contém o conjunto de dados do BigQuery. Se você criar a conta de serviço no mesmo projeto que o conjunto de dados do BigQuery, ela será adicionada como principal automaticamente ao projeto.

Se você criar a conta de serviço em um projeto diferente do projeto que contém o conjunto de dados do BigQuery, será necessário adicionar a conta de serviço ao projeto do conjunto de dados do BigQuery em uma etapa extra.

Para criar uma conta de serviço, conclua estas etapas:

1. No console do Google Cloud, acesse a página Contas de serviço do IAM e do administrador.

   Acessar Contas de serviço

2. Se solicitado, selecione o projeto do Google Cloud.

3. Clique em Criar conta de serviço.

4. Especifique um nome para a conta de serviço e, opcionalmente, uma descrição.

5. Clique em Criar e continuar.

6. Se você estiver criando a conta de serviço no mesmo projeto que o conjunto de dados do BigQuery, no painel Conceder à conta de serviço acesso ao projeto, selecione os seguintes papéis:

   • Editor de dados do BigQuery
   • Usuário de jobs do BigQuery

   Se você estiver criando a conta de serviço em um projeto diferente do conjunto de dados do BigQuery, não conceda papéis a essa conta.

7. Clique em Continuar.

8. Conceda aos outros usuários acesso à conta de serviço, conforme adequado.

9. Clique em Concluído. A conta de serviço aparece na lista de contas de serviço do projeto.

10. Se você criou a conta de serviço em um projeto diferente daquele que contém o conjunto de dados do BigQuery, anote o nome da conta de serviço. Você especifica o nome ao adicionar a conta de serviço ao projeto do BigQuery. Para mais informações, consulte Adicionar a conta de serviço ao projeto do BigQuery.

A conta de serviço agora está listada como principal na página Permissões do IAM do projeto do Google Cloud em que a conta de serviço foi criada.

Adicionar a conta de serviço ao projeto do BigQuery

Se você criou a conta de serviço para o BigQuery Connector para SAP em um projeto diferente do projeto que contém o conjunto de dados de destino do BigQuery, será necessário adicionar a conta de serviço ao projeto de conjunto de dados do BigQuery.

Se você tiver criado a conta de serviço no mesmo projeto que o conjunto de dados do BigQuery, pule esta etapa.

Para adicionar uma conta de serviço atual ao projeto do conjunto de dados do BigQuery, conclua as etapas a seguir:

1. No console do Google Cloud, abra a página de permissões do IAM.

   Acessar as permissões do IAM

2. Confirme se o nome do projeto que contém o conjunto de dados de destino do BigQuery é exibido próximo ao topo da página. Por exemplo:

   Permissões do projeto "PROJECT_NAME"

   Caso contrário, mude de projeto.

3. Na página IAM, clique em Adicionar. A caixa de diálogo Adicionar principais à "PROJECT_NAME" será aberta.

4. Na caixa de diálogo Adicionar principais a "PROJECT_NAME", conclua as seguintes etapas:

   1. No campo Novos principais, especifique o nome da conta de serviço.
   2. No campo Selecionar papel, especifique Editor de dados do BigQuery.
   3. Clique em ADICIONAR OUTRO PAPEL. O campo Selecionar papel é exibido novamente.
   4. No campo Selecionar papel, especifique Usuário de jobs do BigQuery.
   5. Clique em Salvar. A conta de serviço aparece na lista de principais do projeto na página IAM.

A conta de serviço agora pode ser usada para acessar o conjunto de dados do BigQuery neste projeto.

Configurar certificados SSL e HTTPS

A comunicação entre o BigQuery Connector para SAP e a API BigQuery é protegida usando SSL e HTTPS.

1. Faça o download dos seguintes certificados no repositório Google Trust Services:

   • GTS Root R1
   • GTS CA 1C3

2. Na GUI do SAP, use a transação STRUST para importar o certificado raiz e subordinado para a pasta PSE SSL client SSL Client (Standard).

   Para mais informações da SAP, consulte a Ajuda da SAP: manter a lista de certificações do PSE.

3. No host do SAP LT Replication Server, confirme se as regras de firewall ou os proxies estão configurados para permitir o tráfego de saída da porta HTTPS para a API BigQuery.

   Especificamente, o SAP LT Replication Server precisa ser capaz de acessar as seguintes APIs do Google Cloud:

   • https://bigquery.googleapis.com
   • https://iamcredentials.googleapis.com

   Se você quiser que o BigQuery Connector para SAP acesse as APIs do Google Cloud usando endpoints do Private Service Connect na rede VPC, será necessário configurar destinos de RFC e especificar os endpoints do Private Service Connect nesses destinos de RFC. Para mais informações, consulte Destinos de RFC.

Para mais informações da SAP sobre a configuração do SSL, consulte a Nota SAP 510007 – Considerações adicionais para configurar a SSL no Application Server ABAP.

Criar configurações do ABAP

Criar destinos de RFC

Os destinos do RFC GOOG_OAUTH2_TOKEN, GOOG_IAMCREDENTIALS e GOOG_BIGQUERY são importados como parte do transportador do BigQuery Connector para SAP. Caso esses destinos de RFC não sejam importados, será necessário criar novos destinos de RFC GOOG_OAUTH2_TOKEN, GOOG_IAMCREDENTIALS e GOOG_BIGQUERY usando a transação SM59.

Para informações sobre como criar destinos de RFC, consulte Configurar destinos de RFC.

Especificar as configurações de acesso em /GOOG/CLIENT_KEY

Use a transação SM30 para especificar as configurações de acesso ao Google Cloud. O conector do BigQuery para SAP armazena as configurações como um registro na tabela de configuração personalizada /GOOG/CLIENT_KEY.

Para especificar as configurações de acesso, siga estas etapas:

1. Na GUI do SAP, insira o código da transação SM30.

2. Selecione a tabela de configuração /GOOG/CLIENT_KEY.

3. Insira valores para os seguintes campos da tabela:

   Campo	Tipo de dado	Descrição
   Nome	String	O nome desta configuração CLIENT_KEY.
   Nome da conta de serviço	String	O nome da conta de serviço, em formato de endereço de e-mail, que foi criada para o BigQuery Connector para SAP na etapa Criar uma conta de serviço. Por exemplo, [e-mail].
   Escopo	String	O escopo de acesso. Especifique o escopo de acesso da API https://www.googleapis.com/auth/cloud-platform, conforme recomendado pelo Compute Engine.
   ID do projeto	String	O ID do projeto que contém o conjunto de dados de destino do BigQuery.
   Nome do comando	String	Deixe esse campo em branco.
   Classe de autorização	String	A classe de autorização. Especifique /GOOG/CL_GCP_AUTH_JWT.
   Campo de autorização	Não relevante	Deixe esse campo em branco.
   Token de atualização em segundos	Número inteiro	Deixe esse campo em branco.

Especifique destinos RFC em /GOOG/SERVIC_MAP

Use a transação SM30 para especificar destinos RFC na tabela de mapeamento de serviço /GOOG/SERVIC_MAP.

Para especificar os destinos de RFC, siga estas etapas:

1. Na GUI do SAP, insira o código da transação SM30.

2. Na tabela /GOOG/CLIENT_KEY que você criou na seção anterior, anote o valor do campo Nome.

3. Na tabela /GOOG/SERVIC_MAP, crie entradas com os seguintes valores de campo:

Nome	Nome do serviço	Destino do RFC
CLIENT_KEY_TABLE_NAME	googleapis.com/oauth2	GOOG_OAUTH2_TOKEN
CLIENT_KEY_TABLE_NAME	iamcredentials.googleapis.com	GOOG_IAMCREDENTIALS

Substitua CLIENT_KEY_TABLE_NAME pelo nome da tabela que você anotou na etapa anterior.

Fazer o download do pacote de instalação

Faça o download do pacote de instalação mais recente do BigQuery Connector para SAP no portal de download do BigQuery Connector para SAP.

Você precisa do número do Cloud Billing para concluir o download. Saiba mais sobre contas de faturamento em Cloud Billing e perfil para pagamentos.

O pacote de instalação inclui arquivos de transporte que você copia no diretório de transporte apropriado para o SAP LT Replication Server.

Instalar o BigQuery Connector para SAP

Depois que você receber o pacote de instalação que contém os arquivos de transporte do BigQuery Connector para SAP, o administrador poderá instalar o BigQuery Connector para SAP importando os arquivos de transporte para o SAP LT Replication Server.

O transporte do SAP para BigQuery Connector para SAP contém todos os objetos necessários para o BigQuery Connector para SAP, incluindo o namespace /GOOG/, os objetos DDIC e a implementação e classes do SLT do SDK SLT. relatórios e muito mais.

Antes de importar os arquivos de transporte para o SAP LT Replication Server, verifique se seu servidor é compatível com o BigQuery Connector para SAP, conforme documentado em Requisitos de software.

Mesmo usando uma versão compatível do SAP LT Replication Server, em alguns casos, ao importar os arquivos de transporte, você pode ver a mensagem de erro Requests do not match the component version of the target system. Nesses casos, importe novamente os arquivos de transporte para o SAP LT Replication Server e, na reimportação, na tela Solicitação de transporte de importação, acesse Opções e marque a caixa de seleção Ignorar versão do componente inválida.

Aviso:

Se você precisar instalar o BigQuery Connector para SAP em uma máquina host em que o ABAP SDK for Google Cloud já esteja instalado, entre em contato com o Cloud Customer Care para receber instruções de instalação apropriadas sobre sua configuração. A instalação do BigQuery Connector para SAP sem seguir as instruções do atendimento ao cliente pode tornar o SDK ABAP para Google Cloud inoperante.

Para encontrar os dados de contato do Customer Care, acesse a página Visão geral do suporte no Console do Google Cloud. Para mais informações, consulte Como receber suporte para a SAP no Google Cloud.

O procedimento a seguir é geral. Cada sistema SAP é diferente. Por isso, trabalhe com seu administrador SAP para determinar as alterações no procedimento que podem ser necessárias para o sistema SAP:

1. Copie o conector do BigQuery para arquivos de transporte SAP para os seguintes diretórios de importação de transporte do SAP LT Replication Server:

   • /usr/sap/trans/cofiles/KXXXXXX.ED1
   • /usr/sap/trans/data/RXXXXXX.ED1

   Nos exemplos anteriores, XXXXXX representa o nome do arquivo numerado.

2. Na GUI do SAP, use o código de transação STMS_IMPORT ou STMS para importar os arquivos para o sistema SAP.

3. Verifique se todos os objetos no pacote /GOOG/SLT_SDK estão ativos e são consistentes:

   1. Na interface do SAP, insira o código da transação SE80.
   2. No seletor de pacote, selecione /GOOG/SLT_SDK.

   3. No campo Nome do objeto, clique com o botão direito do mouse no pacote /GOOG/SLT_SDK e escolha Verificar > Verificação do pacote > Objetos do pacote.

      Uma marca de seleção verde na coluna Result indica que todos os objetos passaram na verificação do pacote.

Confirmar se o conector do BigQuery para SAP está pronto para ser configurado

Para confirmar ainda mais que os arquivos de transporte foram importados corretamente e que o BigQuery Connector para SAP está pronto para ser configurado, confirme se a implementação do BigQuery Business for SAP Business Add-in (BAdI) está ativa e se o BigQuery O conector para aplicativos de replicação do SAP tem entradas na tabela IUUC_REPL_APPL.

1. Verifique a implementação do BAdI:
   1. Use a transação SE80 para navegar e selecionar a pasta de objeto de aprimoramento /GOOG/EI_IUUC_REPL_RUNTIME_BQ.
   2. Selecione Enh. implementar elementos no lado direito da página.
   3. Em Comportamento de tempo de execução, confirme se a Implementação está ativa se está marcada.
2. Verifique os aplicativos de replicação:
   1. Usando o navegador de dados do SAP ou a transação SE16, exiba a tabela IUUC_REPL_APPL.
   2. Confirme se os seguintes aplicativos aparecem na tabela IUUC_REPL_APPL:
      • /GOOG/SLT_BQ
      • ZGOOG_SLT_BQ, para uso quando o namespace /GOOG/ não estiver registrado

Criar papéis e autorizações do SAP para BigQuery Connector para SAP

Para trabalhar com o conector do BigQuery para SAP, além das autorizações padrão do servidor de replicação do SAP LT, os usuários precisam de acesso às transações personalizadas fornecidas com o conector do BigQuery para SAP: /GOOG/SLT_SETTINGS e /GOOG/REPLIC_VALID.

Para usar a ferramenta de simulação de carga, os usuários precisam acessar a transação personalizada /GOOG/LOAD_SIMULATE fornecida com o BigQuery Connector para SAP.

Por padrão, os usuários que têm acesso a transações /GOOG/SLT_SETTINGS e /GOOG/REPLIC_VALID personalizadas podem modificar as configurações de qualquer configuração. Portanto, se necessário, você pode restringir o acesso a configurações específicas. Para usuários que só precisam visualizar as configurações do BigQuery Connector para SAP, é possível conceder a eles acesso somente leitura à transação personalizada /GOOG/SLT_SETT_DISP.

Os arquivos de transporte do BigQuery Connector para SAP incluem o objeto Google BigQuery Settings Authorization, ZGOOG_MTID, para autorizações específicas do BigQuery Connector para SAP.

Para conceder acesso às transações personalizadas e restringir o acesso a configurações específicas, siga estas etapas:

1. Como usar o código de transação SAPPFCG, defina um papel para o conector do BigQuery para SAP.

2. Conceda o papel de acesso às transações personalizadas /GOOG/SLT_SETTINGS, /GOOG/REPLIC_VALID e /GOOG/LOAD_SIMULATE.

3. Para limitar o acesso de um papel, especifique o grupo de autorização de cada configuração que o papel pode acessar usando o objeto de autorização ZGOOG_MTID. Por exemplo:

   • Objeto de autorização para o BigQuery Connector para SAP (ZGOOG_MTID):
     • Activity 01
     • Authorization Group AUTH_GROUP_1,AUTH_GROUP_N

   AUTH_GROUP_01 e AUTH_GROUP_N são valores definidos na configuração do SAP LT Replication Server.

   Os grupos de autorização especificados para ZGOOG_MTID precisam corresponder aos grupos de autorização especificados para o papel no objeto de autorização S_DMIS_SLT do SAP.

Criar papéis e autorizações do SAP para visualizar as configurações do BigQuery Connector para SAP

Para conceder acesso somente leitura para a transação personalizada /GOOG/SLT_SETT_DISP, siga estas etapas:

1. Usando o código de transação SAP PFCG, defina um papel para visualizar as configurações do conector do BigQuery para SAP.

2. Conceda o acesso do papel à transação personalizada /GOOG/SLT_SETT_DISP.

3. Adicione o objeto de autorização do conector do BigQuery para SAP (ZGOOG_MTID) com os seguintes atributos:

   • Activity 03
   • Authorization Group = *

4. Gere o perfil e atribua os usuários relevantes à função.

Configurar replicação

Para configurar a replicação, especifique as configurações do BigQuery Connector para SAP e do SAP LT Replication Server.

Especificar as configurações de acesso em /GOOG/CLIENT_KEY

Use a transação SM30 para especificar as configurações de acesso ao BigQuery. O conector do BigQuery para SAP armazena as configurações como um registro na tabela de configuração personalizada /GOOG/CLIENT_KEY.

Para especificar as configurações de acesso:

1. Na GUI do SAP, insira o código da transação SM30.

2. Selecione a tabela de configuração /GOOG/CLIENT_KEY.

3. Insira valores para os seguintes campos da tabela:

   Campo	Tipo de dado	Descrição
   Nome	String	O nome desta configuração CLIENT_KEY.
   Nome da conta de serviço	String	Deixe esse campo em branco.
   Escopo	String	Deixe esse campo em branco.
   ID do projeto	String	O ID do projeto que contém o conjunto de dados de destino do BigQuery.
   Nome do comando	String	O nome do comando de sistema operacional externo definido na etapa Criar um comando do SO para imprimir o token de acesso.
   Classe de autorização	String	A classe de autorização a ser usada na replicação. Especifique /GOOG/CL_GCP_AUTH.
   Campo de autorização	Não relevante	Deixe esse campo em branco.
   Token de atualização em segundos	Inteiro	O tempo (em segundos) que um token de acesso expira e precisa ser atualizado. O valor padrão é 3500. É possível substituir esse valor padrão definindo um valor para o parâmetro CMD_SECS_DEFLT nas configurações avançadas. Especificar um valor de 1 a 3599 substitui o prazo de validade padrão. Se você especificar 0, o BigQuery Connector para SAP usará o valor padrão.
   Armazenamento de tokens em cache	Booleano	A sinalização que determina se os tokens de acesso recuperados do Google Cloud são armazenados em cache. Recomendamos que você ative o armazenamento do token em cache após concluir a configuração do BigQuery Connector para SAP e testar a conexão com o Google Cloud. Para mais informações sobre o armazenamento do token em cache, consulte Ativar o armazenamento do token em cache.

Configurar destinos de RFC

Para conectar o BigQuery Connector para SAP ao Google Cloud, recomendamos que você use destinos RFC.

Para configurar os destinos de RFC para sua replicação:

1. Na GUI do SAP, insira o código da transação SM59.

2. (Recomendado) Para criar novos destinos de RFC, copie as amostras de RFC de destino GOOG_BIGQUERY e GOOG_IAMCREDENTIALS e anote os novos nomes de destino do RFC. Elas serão usadas em etapas posteriores.

   O BigQuery Connector para SAP usa destinos RFC para se conectar às APIs do BigQuery e do IAM, respectivamente.

   Se você quiser testar a conectividade baseada no destino do RFC, pule esta etapa e use os destinos de RFC de amostra.

3. Para os destinos de RFC que você criou, siga estas etapas:

   1. Acesse a guia Configurações técnicas e verifique se o campo Número do serviço está definido com o valor 443. Essa é a porta usada pelo destino RFC para uma comunicação segura.

   2. Acesse a guia Logon único e segurança e verifique se o campo Certificado SSL está definido com a opção Cliente SSL DFAULT (padrão).

   3. Também é possível definir configurações de proxy, ativar a compactação do HTTP e especificar endpoints do Private Service Connect.

   4. Salve as alterações.

   5. Para testar a conexão, clique em Teste de conexão.

      É aceitável e esperado uma resposta que contenha 404 Not Found, porque o endpoint especificado no destino RFC corresponde a um serviço do Google Cloud, e não a um recurso específico hospedado pelo serviço. Essa resposta indica que o serviço de destino do Google Cloud está acessível e que nenhum recurso de destino foi encontrado.

4. Na GUI do SAP, insira o código da transação SM30.

5. Na tabela /GOOG/CLIENT_KEY que você criou na seção anterior, anote o valor do campo Nome.

6. Na tabela /GOOG/SERVIC_MAP, crie entradas com os seguintes valores de campo:

   Nome da chave do Google Cloud	Nome do serviço do Google	Destino do RFC
   CLIENT_KEY_TABLE_NAME	bigquery.googleapis.com	Especifique o nome do destino RFC que segmenta o BigQuery. Se você estiver usando o destino RFC de amostra para testes, especifique GOOG_BIGQUERY.
   CLIENT_KEY_TABLE_NAME	iamcredentials.googleapis.com	Especifique o nome do destino RFC que segmenta o IAM. Se você estiver usando o destino RFC de amostra para testes, especifique GOOG_IAMCREDENTIALS.

   Substitua CLIENT_KEY_TABLE_NAME pelo nome da chave do cliente que você anotou na etapa anterior.

Definir as configurações de proxy

Ao usar destinos RFC para se conectar ao Google Cloud, você pode encaminhar a comunicação do BigQuery Connector para SAP pelo servidor proxy que você estiver usando no ambiente SAP.

Se você não quiser usar um servidor proxy ou não tiver um no ambiente SAP, pule esta etapa.

Para definir as configurações do servidor proxy para o BigQuery Connector for SAP, siga estas etapas:

1. Na GUI do SAP, insira o código da transação SM59.

2. Selecione o destino RFC que segmenta o IAM.

3. Acesse a guia Configurações técnicas e insira os valores dos campos na seção Opções de proxy HTTP.

4. Repita a etapa anterior para o destino do RFC que segmenta o BigQuery.

Ativar compactação HTTP

Ao usar destinos RFC para se conectar ao Google Cloud, é possível ativar a compactação HTTP.

Se não quiser ativar essa funcionalidade, pule esta etapa.

Para ativar a compactação HTTP, siga estas etapas:

1. Na GUI do SAP, insira o código da transação SM59.

2. Selecione o destino RFC que segmenta o BigQuery.

3. Acesse a guia Opções especiais.

4. No campo Versão HTTP, selecione HTTP 1.1.

5. No campo Compactação, selecione um valor apropriado.

   Para informações sobre as opções de compactação, consulte a Nota SAP 1037677: a compactação HTTP compacta apenas alguns documentos.

Especificar endpoints do Private Service Connect

Se você quiser que o BigQuery Connector para SAP use endpoints do Private Service Connect para permitir o consumo particular do BigQuery e do IAM, será necessário criar esses endpoints no projeto do Google Cloud e especificá-los nos respectivos destinos RFC.

Se você quiser que o BigQuery Connector para SAP continue usando os endpoints de API públicos padrão para se conectar ao BigQuery e ao IAM, ignore esta etapa.

Para configurar o BigQuery Connector para SAP para usar os endpoints do Private Service Connect, siga estas etapas:

1. Na GUI do SAP, insira o código da transação SM59.

2. Verifique se você criou novos destinos de RFC para o BigQuery e o IAM. Para instruções sobre como criar esses destinos de RFC, consulte Configurar destinos de RFC.

3. Selecione o destino do RFC que segmenta o BigQuery e conclua as seguintes etapas:

   1. Acesse a guia Configurações técnicas.

   2. No campo Host de destino, insira o nome do endpoint do Private Service Connect que você criou para acessar o BigQuery.

   3. Acesse a guia Login e segurança.

   4. No campo Número do serviço, verifique se o valor 443 está especificado.

   5. No campo Certificado SSL, verifique se a opção Cliente SSL DFAULT (padrão) está selecionada.

4. Selecione o destino do RFC que segmenta o IAM e conclua as seguintes etapas:

   1. Acesse a guia Configurações técnicas.

   2. No campo Host de destino, insira o nome do endpoint do Private Service Connect que você criou para acessar o IAM.

   3. Acesse a guia Login e segurança.

   4. No campo Número do serviço, verifique se o valor 443 está especificado.

   5. No campo Certificado SSL, verifique se a opção Cliente SSL DFAULT (padrão) está selecionada.

Ativar o armazenamento do token em cache

Para melhorar o desempenho da replicação, recomendamos que você ative o armazenamento do token de acesso em cache, recuperado do Google Cloud para acessar o BigQuery.

A ativação do armazenamento do token em cache garante que um token de acesso seja reutilizado até que o token de acesso expire ou seja revogado, o que, por sua vez, reduz o número de chamadas HTTP feitas para recuperar novos tokens de acesso.

Para ativar o armazenamento de tokens em cache, selecione a flag Armazenamento do token em cache na tabela de chaves do cliente /GOOG/CLIENT_KEY.

Quando você ativa o armazenamento do token em cache, o token de acesso é armazenado em cache na memória compartilhada do servidor do aplicativo SAP LT Replication Server com a duração definida no campo Segundos de atualização de token na tabela /GOOG/CLIENT_KEY. Se a opção Segundos de atualização de token não for especificada ou for definida como 0, o token de acesso será armazenado em cache pelo valor especificado no parâmetro CMD_SECS_DEFLT em configurações avançadas.

Para cargas de trabalho SAP que não estão em execução no Google Cloud, os tokens de acesso armazenados em cache também evitam problemas técnicos que possam surgir ao replicar grandes carregamentos de dados, em que vários processos do SAP LT Replication Server podem solicitar simultaneamente um token de acesso a qualquer momento.

Limpar o token de acesso armazenado em cache

Quando o armazenamento do token em cache está ativado e você atualiza os papéis atribuídos à conta de serviço que o BigQuery Connector para SAP usa para acessar o BigQuery, o novo token de acesso correspondente aos papéis atualizados é recuperado apenas após o token existente armazenado em cache expirar. Nessas situações, é possível limpar o token de acesso manualmente.

Para limpar o token de acesso armazenado em cache, insira a transação SE38 e execute o programa /GOOG/R_CLEAR_TOKEN_CACHE.

Criar uma configuração de replicação do SAP LT Replication Server

Use a transação SAP LTRC para criar uma configuração de replicação do servidor SAP LT Replication.

Se o servidor de replicação do SAP LT estiver em execução em um servidor diferente do sistema SAP de origem, antes de criar uma configuração de replicação, confirme se você tem uma conexão RFC entre os dois sistemas.

Algumas das configurações de replicação afetam o desempenho. Para determinar os valores de configuração apropriados para sua instalação, consulte o Guia de otimização de desempenho da sua versão do SAP LT Replication Server no Portal de ajuda da SAP.

As opções de interface e configuração do SAP LT Replication Server podem ser um pouco diferentes, dependendo da versão usada.

Para configurar a replicação, use o procedimento para sua versão do SAP LT Replication Server:

• Configurar a replicação no DMIS 2011 SP17, DMIS 2018 SP02 ou posterior
• Configurar a replicação no DMIS 2011 SP16, DMIS 2018 SP01 ou anterior

Configurar a replicação no DMIS 2011 SP17, DMIS 2018 SP02 ou posterior

As etapas a seguir configuram a replicação em versões posteriores do SAP LT Replication Server. Se você estiver usando uma versão anterior, consulte Configurar a replicação no DMIS 2011 SP16, DMIS 2018 SP01 ou anterior.

1. Na GUI do SAP, insira o código da transação LTRC.

2. Clique no ícone Create configuration. O assistente Criar configuração é aberto.

3. Nos campos Nome da configuração e Descrição, insira um nome e uma descrição para a configuração e clique em Avançar.

   Você pode especificar o Grupo de autorização para restringir o acesso a um grupo de autorização específico agora ou mais tarde.

4. No painel Detalhes da conexão do sistema de origem:

   • Selecione o botão de opção RFC Connections.
   • No campo Destino do RFC, especifique o nome da conexão RFC para o sistema de origem.
   • Selecione as caixas de seleção Permitir uso múltiplo e Ler a partir do cliente único conforme apropriado. Para mais informações, consulte a documentação do servidor SAP LT Replication.
   • Clique em Próxima.

   Estas etapas são para uma conexão RFC, mas se a fonte for um banco de dados, será possível selecionar DB Connection se você já tiver definido uma conexão usando a transação DBACOCKPIT.

5. No painel Detalhes da conexão do sistema de destino:

   • Selecione o botão de opção Outro.
   • No campo Cenário, selecione SDK SLT no menu suspenso.
   • Clique em Próxima.

6. No painel Specify Transfer Settings:

   1. No campo Aplicativo da seção Configurações da transferência de dados, insira /GOOG/SLT_BQ ou ZGOOG_SLT_BQ.

   2. Na seção Opções de job, insira valores iniciais em cada um dos seguintes campos:

      • Número de jobs de transferência de dados
      • Número de jobs de carregamento inicial
      • Número de jobs de cálculo

   3. Na seção Opções de replicação, selecione o botão de opção Tempo real.

   4. Clique em Próxima.

7. Depois de revisar a configuração, clique em Salvar.

8. Anote o ID de três dígitos na coluna Transferência de massa. Ele será usado em uma etapa posterior.

Para mais informações, consulte o PDF anexado à Nota SAP 2652704 (em inglês): Como replicar dados usando o SDK SLT - DMIS 2011 SP17, DMIS 2018 SP02.pdf (em inglês).

Configurar replicação no DMIS 2011 SP16, DMIS 2018 SP01 ou anterior

As etapas a seguir configuram a replicação em versões anteriores do SAP LT Replication Server. Se você estiver usando uma versão posterior, consulte Configurar a replicação no DMIS 2011 SP17, DMIS 2018 SP02 ou posterior.

1. Na GUI do SAP, insira o código da transação LTRC.
2. Clique em Novo. Uma caixa de diálogo será aberta para especificar uma nova configuração.
3. Na etapa Specify Source System:
   • Escolha Conexão RFC como o tipo de conexão.
   • Digite o nome da conexão RFC.
   • Verifique se a opção Permitir vários usos está selecionada.
4. Na etapa Specify Target System:
   • Digite os dados de conexão com o sistema de destino.
   • Escolha Conexão RFC como o tipo de conexão.
   • No campo Cenário para a comunicação do RFC, selecione o valor Gravar dados no destino usando o BAdI na lista suspensa. A conexão RFC é definida automaticamente como NONE.
5. Na etapa Specify Transfer Settings, pressione F4 Help. O aplicativo definido anteriormente é exibido no campo Aplicativo.
6. Anote o ID de três dígitos na coluna Transferência de massa. Ele será usado em uma etapa posterior.

Para mais informações, consulte o PDF anexado à Nota SAP 2652704: Como replicar dados usando o SDK SLT - DMIS 2011 SP15, SP16, DMIS 2018 SP00, SP01.pdf.

Criar uma configuração de transferência em massa para o BigQuery

Use a transação personalizada /GOOG/SLT_SETTINGS para configurar uma transferência em massa para o BigQuery e especificar os mapeamentos de tabela e campo.

Selecionar as opções iniciais de transferência em massa

Ao inserir a transação /GOOG/SLT_SETTINGS pela primeira vez, selecione qual parte da configuração de transferência de massa do BigQuery você precisa editar.

Para selecionar a parte da configuração de transferência em massa:

1. Na GUI do SAP, insira a transação /GOOG/SLT_SETTINGS precedida por /n:

   /n/GOOG/SLT_SETTINGS

2. No menu suspenso Tabela de configurações, na tela de inicialização da transação /GOOG/SLT_SETTINGS, selecione Transferências em massa.

   Para uma nova configuração de transferência em massa, deixe o campo Chave de transferência em massa em branco.

3. Clique no ícone Executar. A tela Manutenção de configurações do BigQuery: transferências em massa será exibida.

Especificar a criação de tabelas e outros atributos gerais

Na seção inicial de uma configuração de transferência em massa do BigQuery, identifique a configuração da transferência em massa e especifique a chave do cliente associada, além de determinadas propriedades relacionadas à criação da tabela de destino do BigQuery.

O SAP LT Replication Server salva a configuração de transferência em massa como um registro na tabela de configuração personalizada /GOOG/BQ_MASTR.

Os campos especificados nas etapas a seguir são obrigatórios.

1. Na tela Manutenção de configurações do BigQuery: transferências em massa, clique no ícone Anexar linha.

2. Na linha exibida, especifique as seguintes configurações:

   1. No campo Chave da transferência em massa, defina um nome para esta transferência. Esse nome se torna a chave primária da transferência em massa.
   2. No campo Mass Transfer ID, digite o ID de três dígitos gerado quando você cria a configuração de replicação do SAP LT Replication Server correspondente.
   3. Para usar os rótulos ou as descrições curtas dos campos de origem como nomes para os campos de destino no BigQuery, clique na caixa de seleção Usar sinalização de nomes personalizados. Para mais informações sobre nomes de campos, consulte Opções de nomenclatura padrão para campos.

   4. Para armazenar o tipo de alteração que acionou uma inserção e ativar a validação das contagens de registros entre a tabela de origem, as estatísticas do servidor de replicação do SAP LT e a tabela do BigQuery, selecione a caixas de seleção Sinalização de campos extras.

      Quando essa sinalização é definida, o BigQuery Connector para SAP adiciona colunas ao esquema da tabela do BigQuery. Para mais informações, consulte Campos extras para alterações de registro e consultas de contagem.

   5. Para interromper o envio de dados quando um registro com um erro de dados é encontrado, a caixa de seleção Break at First Error Flag fica marcada por padrão. Recomendamos deixar essa opção marcada. Para mais informações, consulte A sinalização BREAK.

   6. Para reduzir automaticamente o tamanho do bloco quando o tamanho de bytes de um bloco excede o tamanho máximo de bytes para solicitações HTTP aceitas pelo BigQuery, clique na caixas de seleção Flag de tamanho dinâmico do bloco. Para ver mais informações sobre o tamanho dinâmico de blocos, consulte Tamanho dinâmico de blocos.

   7. Quando um registro com um erro de dados é encontrado, para ignorar o registro e continuar inserindo registros na tabela do BigQuery, clique na caixa de seleção Pular sinalização de registros inválidos. Recomendamos deixar esta opção desmarcada. Para mais informações, consulte Sinalização do SKIP.

   8. No campo Nome do Google Cloud Key, insira o nome da configuração /GOOG/CLIENT_KEY correspondente.

      O conector do BigQuery para SAP recupera o identificador do projeto do Google Cloud automaticamente da configuração /GOOG/CLIENT_KEY.

   9. No campo Conjunto de dados do BigQuery, insira o nome do conjunto de dados de destino do BigQuery que você criou anteriormente neste procedimento.

   10. No campo É configurar a sinalização ativa, clique na caixa de seleção para ativar a configuração da transferência em massa.

   11. Clique em Salvar.

       Um registro de transferência em massa é anexado à tabela /GOOG/BQ_MASTR e os campos Changed by, Changed On e Changed At são preenchidos automaticamente.

   12. Clique em Exibir tabela.

       O novo registro de transferência em massa é exibido seguido pelo painel de entrada do atributo da tabela.

Especificar atributos de tabela

É possível especificar os atributos da tabela, como o nome e o particionamento da tabela, bem como o número de registros a serem incluídos em cada transmissão ou bloco enviado ao BigQuery. seção da transação /GOOG/SLT_SETTINGS.

As configurações especificadas são armazenadas como um registro na tabela de configuração /GOOG/BQ_TABLE.

Essas configurações são opcionais.

Para especificar os atributos da tabela:

1. Clique no ícone Anexar linha.

2. No campo SAP Table Name, insira o nome da tabela SAP de origem.

3. No campo Nome da tabela externa, insira o nome da tabela de destino do BigQuery. Se a tabela de destino ainda não existir, o BigQuery Connector para SAP criará a tabela com esse nome. Para saber mais sobre as convenções de nomenclatura do BigQuery nas tabelas, consulte Nomenclatura de tabelas.

4. Para enviar dados não compactados para todos os campos de uma tabela, selecione Send Uncompressed Flag. Com essa configuração ativada, o BigQuery Connector para SAP replica todos os campos vazios nos registros de origem com os valores com que os campos são inicializados na tabela de origem. Para melhorar o desempenho, não selecione essa flag.

   Se você precisar enviar dados não compactados apenas para campos específicos, não selecione Send Uncompressed Flag no nível da tabela. Em vez disso, selecione Send Uncompressed Flag para esses campos específicos no nível do campo. Essa opção permite reter os valores iniciais de campos específicos ao replicar dados no BigQuery, mesmo que você esteja comprimindo o restante dos dados da tabela. Para saber como modificar a compactação de registros no nível do campo, consulte Mudar a compactação de registros no nível do campo.

   Para mais informações sobre o comportamento de compactação de registros, consulte Compactação de registros.

5. Opcionalmente, no campo Chunk Size, especifique o número máximo de registros a serem incluídos em cada bloco enviado para o BigQuery. Recomendamos que você use o tamanho de bloco padrão com o BigQuery Connector para SAP, que é de 10.000 registros. Se necessário, é possível aumentar o tamanho do bloco para até 50.000 registros, que é o tamanho máximo permitido pelo BigQuery Connector para SAP.

   Se os registros de origem tiverem um grande número de campos, o número de campos poderá aumentar o tamanho geral dos bytes dos blocos, o que pode causar erros nos blocos. Se isso ocorrer, tente reduzir o tamanho do bloco para diminuir o tamanho do byte. Para mais informações, consulte Tamanho do bloco no BigQuery Connector para SAP. Como alternativa, para ajustar automaticamente o tamanho do bloco, ative o tamanho dinâmico do bloco. Para ver mais informações, consulte Tamanho dinâmico do bloco.

6. Opcionalmente, no campo Tipo de partição, especifique um incremento de tempo a ser usado para particionamento. Os valores válidos são HOUR, DAYMONTH ou YEAR. Para mais informações, consulte Particionamento de tabelas.

7. Opcionalmente, no campo Partition Field, especifique o nome de um campo na tabela de destino do BigQuery que contém um carimbo de data/hora para uso no particionamento. Ao especificar o Campo de partição, especifique também o Tipo de partição. Para mais informações, consulte Particionamento de tabelas.

8. No campo É configurar sinalização ativa, ative os atributos da tabela clicando na caixa de seleção. Se a caixa É configurar sinalização ativa não estiver marcada, o BigQuery Connector para SAP criará a tabela do BigQuery com o nome da tabela de origem da SAP, o tamanho padrão de bloco e nenhum particionamento.

9. Clique em Salvar.

   Os atributos são armazenados como um registro no/GOOG/BQ_TABLE tabela de configuração e asAlterada por ,Alterado em eAlterado em são preenchidos automaticamente.

10. Clique em Campos de exibição.

    O novo registro de atributo da tabela é exibido seguido pelo painel de entrada do mapeamento de campo.

Personalizar o mapeamento de campos padrão

Se a tabela SAP de origem contiver campos de booleanos ou booleanos, altere o mapeamento do tipo de dados padrão para refletir com precisão o tipo de dados na tabela de destino do BigQuery.

Também é possível alterar outros tipos de dados, bem como os nomes usados para campos de destino.

É possível editar o mapeamento padrão diretamente na GUI do SAP ou exportar o mapeamento padrão para uma planilha ou um arquivo de texto para que outras pessoas possam editar os valores sem precisar de acesso ao SAP LT Replication Server.

Para mais informações sobre o mapeamento de campos padrão e as alterações que podem ser feitas, consulte Mapeamento de campos.

Para personalizar o mapeamento padrão dos campos de destino do BigQuery:

1. Na página Manutenção de configurações do BigQuery: campos da transação /GOOG/SLT_SETTINGS, mostre os mapeamentos de campo padrão para a transferência em massa que você está configurando.

2. Edite os tipos de dados de destino padrão na coluna External Data Element conforme necessário. Especificamente, altere o tipo de dados de destino para os seguintes tipos de dados:

   • Carimbos de data/hora. Altere o tipo de dados de destino padrão de NUMERIC para TIMESTAMP ou TIMESTAMP (LONG).
   • Booleanos. Altere o tipo de dados de destino padrão de STRING para BOOLEAN.
   • Hexadecimal. Altere o tipo de dados de destino padrão de STRING para BYTES.

   Para editar o mapeamento do tipo de dados padrão:

   1. Na linha do campo que você precisa editar, clique no campo External Data Element.
   2. Na caixa de diálogo para tipos de dados, selecione o tipo de dados do BigQuery que você precisa.
   3. Confirme as alterações e clique em Salvar.

3. Se você especificou a sinalização Nomes personalizados na página Manutenção das configurações do BigQuery, edite os nomes padrão dos campos de destino na coluna Nome de campo temporário conforme necessário.

   Os valores especificados modificam os nomes padrão mostrados na coluna Nome do campo externo.

4. Edite as descrições de campo de destino padrão na coluna Descrição do campo conforme necessário.

5. Como opção, exporte o mapa de campos para edição externa. Para mais instruções, consulte Editar o mapa de campos do BigQuery em um arquivo CSV.

6. Depois que todas as alterações forem concluídas e todos os valores editados externamente forem enviados, confirme se a caixa de seleção É configurar sinalização ativa está marcada. Se a opção É configurar sinalização ativa não estiver selecionada, o BigQuery Connector para SAP criará tabelas de destino com os valores padrão.

7. Clique em Salvar.

   As alterações são armazenadas na tabela de configuração /GOOG/BQ_FIELD e nos campos Changed by, Changed On e Changed at são preenchidos automaticamente.

Mudar a compactação de registros no nível do campo

Para melhorar o desempenho da replicação, o BigQuery Connector para SAP compacta registros omitindo todos os campos vazios no registro de origem, que são inicializados com null na tabela de destino no BigQuery. No entanto, se você precisar replicar alguns campos vazios com os valores iniciais no BigQuery enquanto ainda usa a compactação de registros, selecione Enviar sinalização não compactada para esses campos específicos.

Para mais informações sobre o comportamento de compactação de registros, consulte Compactação de registros.

Para mudar a compactação de registros no nível do campo, siga estas etapas:

1. Na página Manutenção de configurações do BigQuery: campos da transação /GOOG/SLT_SETTINGS, mostre a lista de campos da tabela cuja transferência em massa você está configurando.

2. Para enviar dados não compactados de um campo, selecione Send Uncompressed Flag correspondente ao campo.

3. Clique em Salvar.

Replicação de teste

Teste a configuração de replicação iniciando o provisionamento de dados:

1. Abra o SAP LT Replication Server Cockpit (transação LTRC) na GUI do SAP.

2. Clique na configuração da transferência em massa para a replicação da tabela que você está testando.

3. Clique em Provisionamento de dados.

4. No painel Provisionamento de dados, inicie o provisionamento de dados:

   1. Insira o nome da tabela de origem.
   2. Clique no botão de opção para o tipo de provisionamento de dados que você quer testar. Por exemplo, Start Load.

   3. Clique no ícone Executar. A transferência de dados é iniciada, e o progresso é exibido na tela Objetos participantes.

      Se a tabela não existir no BigQuery, o conector do BigQuery para SAP a criará com base em um esquema criado a partir dos atributos da tabela e de campo definidos anteriormente com a transação /GOOG/SLT_SETTINGS. de dados.

      O período de carregamento inicial de uma tabela depende do tamanho da tabela e dos registros dela.

      As mensagens são gravadas na seção Registros de aplicativos do SAP LT Replication Server na transação LTRC.

Como alternativa, é possível testar a replicação para o BigQuery usando a ferramenta de simulação de carregamento. Para mais informações, consulte Ferramenta de simulação de carregamento.

Validar replicação

Valide a replicação usando os seguintes métodos:

• No servidor de replicação do SAP LT:
  • Monitore a replicação na tela Provisionamento de dados.
  • Verifique se há mensagens de erro na tela Registros de aplicativos.
• Na guia de informações da tabela no BigQuery:
  • Verifique a guia Schema para garantir que o esquema esteja correto.
  • Verifique a guia Visualizar para ver as linhas inseridas.
  • Confira o número de linhas inseridas, o tamanho da tabela e outras informações na guia Detalhes.
• Se a caixa de seleção Sinalização de campos extras estiver marcada quando a tabela do BigQuery foi configurada, execute a ferramenta de validação de replicação digitando a transação personalizada /GOOG/REPLIC_VALID.

Verificar a replicação no SAP LT Replication Server

Use a transação LTRC para ver o progresso dos jobs de carregamento inicial ou de replicação depois de iniciá-los e verificar se há mensagens de erro.

É possível ver o status da carga na guia Load Statistics e o andamento do job na guia Data Transfer Monitor no SAP LT Replication Server de dados.

Na tela Registros de aplicativos da transação LTRC, é possível ver todas as mensagens retornadas pelo BigQuery, o conector do BigQuery para SAP e o SAP LT Replication Server.

As mensagens emitidas pelo BigQuery Connector para o código SAP no SAP LT Replication Server começam com o prefixo /GOOG/SLT. As mensagens retornadas da API BigQuery começam com o prefixo /GOOG/MSG.

As mensagens retornadas pelo SAP LT Replication Server não começam com o prefixo /GOOG/.

Verificar a replicação no BigQuery

No console do Google Cloud, confirme se a tabela foi criada e se o BigQuery está inserindo dados nela.

1. No console do Google Cloud, acesse a página do BigQuery.

   Acessar o BigQuery

2. No campo de pesquisa da seção Explorer, digite o nome da tabela de destino do BigQuery e pressione Enter.

   As informações da tabela são exibidas em uma guia no painel de conteúdo, no lado direito da página.

3. Na seção de informações da tabela, clique nos cabeçalhos a seguir para verificar a inserção em tabela e linha:

   • Visualização, que mostra as linhas e os campos que são inseridos na tabela do BigQuery.
   • Esquema, que mostra os nomes dos campos e os tipos de dados.
   • Detalhes, que mostra o tamanho da tabela, o número total de linhas e outros detalhes.

Executar a ferramenta de validação de replicação

Se a Sinalização de campos extras foi selecionada quando a tabela do BigQuery foi configurada, use a ferramenta de validação de replicação para gerar relatórios que comparam o número de registros na tabela do BigQuery com contagens de registros nas estatísticas do servidor de replicação SAP LT ou na tabela de origem.

Para executar a ferramenta de validação de replicação:

1. Na GUI do SAP, insira a transação /GOOG/REPLIC_VALID precedida por /n:

   /n/GOOG/REPLIC_VALID

2. Na seção Opções de processamento, clique no botão de opção Executar validação.

3. Na seção Opções de seleção, insira as seguintes especificações:

   • No menu suspenso do campo GCP Partner Identifier, selecione BigQuery.
   • No menu suspenso do campo Tipo de verificação, selecione o tipo de relatório para gerar:
     • Contagens de carregamento iniciais
     • Contagens de replicação
     • Contagens atuais
   • Se o campo Data de verificação for exibido, especifique a data para a qual você precisa das contagens.
   • No campo Chave de transferência em massa, digite o nome da configuração.
   • Opcionalmente, no campo Nomes das tabelas, especifique os nomes das tabelas na configuração de transferência em massa para a qual você precisa gerar o relatório.

4. Execute a ferramenta de validação de replicação clicando no ícone Executar.

5. Após a conclusão da verificação de validação, na seção Opções de processamento, exiba o relatório clicando no botão de opção Exibir relatório e, em seguida, no ícone de execução.

Contagens de registro do BigQuery: a ferramenta de validação de replicação sinaliza todas as contagens de registro incompatíveis com um círculo vermelho. No entanto, uma incompatibilidade nas contagens de replicação nem sempre indica um problema.

Uma contagem de registros no BigQuery moderadamente superior à contagem de registros na tabela de origem é normal.

Para mais informações, consulte Contagens de registro desiguais.

Para mais informações, consulte Ferramenta de validação de replicação.

Solução de problemas

Para informações sobre como diagnosticar e resolver problemas que você pode encontrar ao configurar e executar cargas ou replicações entre a SAP e o BigQuery com o Conector do BigQuery para SAP, consulte o Guia de solução de problemas do Conector do BigQuery para SAP.

Receber suporte

Se você precisar de ajuda para resolver problemas de replicação e do conector do BigQuery para SAP, colete todas as informações de diagnóstico disponíveis e entre em contato com o atendimento ao cliente do Cloud. Para mais informações sobre como entrar em contato com o atendimento ao cliente, consulte Como receber suporte para o SAP no Google Cloud.