Guia de solução de problemas do BigQuery Connector para SAP

Para solucionar problemas com a versão 2.8 (mais recente) do BigQuery Connector para SAP, use o registro de aplicativos do SAP LT Replication Server e os registros do Google Cloud para analisar mensagens de erro e de registro.

O BigQuery Connector para SAP envia todos os erros para os registros padrão de aplicativos do SAP LT Replication Server.

Também é possível usar a depuração do SAP LT Replication Server para isolar problemas.

Visão geral sobre a solução de problemas

Ao resolver problemas com o BigQuery Connector para SAP, há várias áreas diferentes em que você precisa focar sua atenção, dependendo da área ou do escopo do problema que você está investigando:

  • a infraestrutura, como a rede, o hardware ou o sistema operacional;
  • O software SAP, incluindo o servidor de origem e o SAP LT Replication Server.
  • Conector do BigQuery para SAP.
  • BigQuery, incluindo a API BigQuery e a tabela de destino.

Envolver as equipes certas

Ao solucionar um problema, o primeiro passo é determinar em quais áreas anteriores ele ocorre e qual é o escopo.

Para resolver um problema, talvez seja necessário trabalhar com várias equipes, como os administradores de base, de administração do SAP LT Replication Server, de DBAs ou do Google Cloud.

Ter as equipes e as habilidades certas envolvidas no processo pode ajudar você a resolver seus problemas com mais rapidez.

Determinar a causa raiz

Você precisa determinar a causa principal do problema e verificar se o que você acredita que pode ser a causa não é apenas um sintoma de uma causa raiz que está em outro lugar.

Os sistemas SAP são totalmente integrados, mas podem gravar registros e traces em arquivos em vários locais diferentes. Ao resolver problemas, você precisa determinar os registros e arquivos de rastreamento corretos para análise.

Verificar os requisitos e os pré-requisitos do software

Verifique se todos os softwares do sistema estão sendo executados nas versões mínimas necessárias e se todos os pré-requisitos do BigQuery Connector para SAP foram atendidos.

Para conferir informações sobre os pré-requisitos de instalação do BigQuery Connector para SAP, consulte:

  • Se o SAP LT Replication Server estiver em execução em uma VM do Compute Engine, consulte Pré-requisitos.

  • Se o SAP LT Replication Server estiver em execução em um host externo ao Google Cloud, consulte Pré-requisitos.

Para requisitos de software do BigQuery Connector para SAP, consulte Requisitos de software.

Se você estiver usando um software ECC mais antigo, verifique se a versão do servidor SAP LT Replication é compatível com a versão do ECC. Para mais informações, consulte a Nota SAP 2577774 - Compatibilidade de versão para sistemas de origem e de destino - SLT (em inglês).

Para o sistema de origem SAP e o SAP LT Replication Server, implemente todas as notas de correção da tecnologia de migração e replicação baseada em ABAP. Para mais informações, consulte a Nota SAP 3016862 - Analisadores de notas do DMIS com cenários separados para tecnologia de migração e replicação baseada em ABAP.

Leia a documentação de suporte do SAP

Se você tiver uma conta de usuário da SAP, poderá encontrar a solução para muitos problemas de software da SAP lendo os artigos SAP Notes e a base de conhecimento da SAP, disponíveis no Launchpad de suporte da SAP ONE (em inglês). de dados.

Logging

O BigQuery Connector para SAP envia mensagens de registro para o SAP LT Replication Server, em que é possível visualizá-las nos registros do aplicativo SAP LT Replication Server.

Essas mensagens incluem as mensagens que o BigQuery Connector para SAP recebe da API BigQuery.

As mensagens gerais de registro do BigQuery podem ser visualizadas no console do Google Cloud.

Registros de aplicativos do servidor SAP LT Replication

Todas as mensagens de erro são salvas nos registros do aplicativo padrão do SAP LT Replication Server. Verifique os registros do aplicativo para analisar e resolver os problemas de causa principal.

Para exibir os registros do aplicativo específicos da configuração do SAP LT Replication Server, execute a transação LTRC, abra a configuração e selecione Registros de aplicativos.

Quando os registros forem exibidos, selecione uma linha da tabela e clique em um botão para exibir as mensagens de erro. Se você clicar na guia Registros de aplicativos de uma replicação, poderá filtrar mensagens de registro do ambiente de execução relevantes para a replicação.

Mensagens geradas pelo BigQuery Connector para SAP

Qualquer erro que ocorrer no BigQuery Connector para SAP antes dos registros serem enviados ao BigQuery será prefixado por /GOOG/SLT.

Qualquer erro retornado da API BigQuery é prefixado por /GOOG/MSG. Isso inclui todos os erros HTTP.

Se um erro não tiver sido prefixado por um desses valores, o erro foi emitido pelo SAP LT Replication Server.

Registros do BigQuery

O BigQuery grava várias entradas de registro no Cloud Logging no console do Google Cloud.

Para ver as entradas de registro do BigQuery:

  1. No console do Google Cloud, abra Logging.

    Acessar o Explorador de registros

  2. No editor Query, especifique um recurso do BigQuery. Por exemplo:

    resource.type="bigquery_dataset"

Para saber mais sobre os registros do BigQuery, consulte Registros.

HTTP Trace

Ao resolver erros, é possível ativar o trace HTTP na transação SMICM ou ST05.

Para limitar o impacto no desempenho, desative o trace HTTP assim que você terminar.

Depuração

Se você tiver a autorização necessária, poderá depurar o código do complemento de negócios (BAdI) do BigQuery Connector para SAP.

Para depurar o código BAdI:

  1. Se você ainda não tem as autorizações SAP necessárias para depurar o código BAdI, solicite-as ao administrador da SAP.

  2. Ative a depuração digitando /h no campo de entrada de transação na GUI do SAP e pressionando Enter.

  3. No menu Settings, selecione Change Debugger Profile/ Settings.

  4. Em Debug Modes, verifique se System Debugging está selecionada.

  5. Defina pontos de interrupção externos no código, conforme necessário.

Monitoramento

É possível monitorar vários pontos diferentes ao longo do caminho de dados da fonte de dados SAP para a tabela de destino do BigQuery, incluindo:

  • Infraestrutura: rede, hardware e sistema operacional
  • Camada de banco de dados SAP
  • Camada de aplicativos SAP
  • Conector do BigQuery para SAP
  • BigQuery

Para mais informações sobre o monitoramento em cada um desses pontos, consulte o Guia de operações do conector do BigQuery para SAP.

Reconciliação de dados

Há três pontos em que você pode verificar as contagens de registros:

  • A tabela de origem
  • As estatísticas de carga ou replicação do SAP LT Replication Server na transação LTRC
  • A tabela de destino do BigQuery

Você pode usar a ferramenta de validação de replicação para verificar e comparar contagens de registros ou pode recuperar os registros por meio da execução de consultas SQL.

Para mais informações sobre reconciliação de dados, consulte o guia de operações do conector do BigQuery para SAP.

Problemas comuns de configuração

Nesta seção, você verá resoluções para problemas comuns que podem ocorrer durante a configuração inicial do conector do BigQuery para SAP.

Compatibilidade com o SAP LT Replication Server para tipos de dados de banco de dados

Dependendo das versões do software SAP, o SAP LT Replication Server pode não ser compatível com alguns tipos de dados em um banco de dados de origem. Para mais informações, consulte a seção Considerações importantes da Nota SAP 1605140 - Servidor de replicação de transformação de paisagem (SLT, na sigla em inglês) SAP (em inglês).

Problema: o comando do SO para o token de acesso não funciona no SAP LT Replication Server

Problema: você criou um comando de sistema operacional (SO) para imprimir o token de acesso, mas ele não está funcionando no servidor de replicação SAP LT.

Causa: esse problema pode ser causado por vários problemas, mas provavelmente é causado pela falta das variáveis de ambiente necessárias para o comando do SO configurado corretamente.

Resolução: confirme se o comando do SO foi configurado corretamente.

Tente executar o comando printenv a partir do SO como o SID_LCadm e da transação SAP SM69 e compare a saída. Se as variáveis retornadas na transação SM69 estiverem incompletas, tente reiniciar o SAP LT Replication Server para registrar as variáveis.

Problema: /GOOG/MSG: 400 - Bad Request Request contains an invalid argument

Problema: falha na transferência de dados com a mensagem de erro /GOOG/MSG: 400 - Bad Request Request contains an invalid argument.

Causa: para a carga de trabalho SAP em execução no Google Cloud, o escopo de acesso usado na tabela de chaves do cliente /GOOG/CLIENT_KEY não é válido.

Resolução: para resolver esse problema, siga estas etapas:

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

    /n/GOOG/SLT_SETTINGS

  2. Para o ID de transferência em massa que falhou na transação LTRC, anote o valor do campo Nome da chave do Google Cloud.

  3. Insira a transação SM30 e abra a tabela /GOOG/CLIENT_KEY.

  4. Para o valor do Nome da chave do Google Cloud que você anotou em uma etapa anterior, verifique se o valor do campo Escopo corresponde ao escopo de acesso mencionado em Especifique as configurações de acesso em /GOOG/CLIENT_KEY. Não insira espaços no campo.

  5. Execute a replicação novamente.

Problema: /GOOG/MSG : 400 - ICM_HTTP_CONNECTION_FAILED

Problema: falha na transferência de dados com a mensagem de erro /GOOG/MSG : 400 - ICM_HTTP_CONNECTION_FAILED.

Causa: nos destinos RFC que o BigQuery Connector para SAP usa para se conectar às APIs do Google Cloud, o valor do Prefixo do caminho ou o campo Host de destino está incorreto.

Resolução: para resolver esse problema, siga estas etapas:

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

    /n/GOOG/SLT_SETTINGS

  2. Para o ID de transferência em massa que falhou na transação LTRC, anote o valor do campo Nome da chave do Google Cloud.

  3. Insira a transação SM30 e abra a tabela /GOOG/SERVIC_MAP.

  4. Para o valor Nome de chave do Google Cloud que você anotou em uma etapa anterior, anote os nomes de destino do RFC.

  5. Insira a transação SM59 e siga estas etapas:

    1. Para o destino RFC que se conecta ao BigQuery, verifique se o valor do campo Prefixo do caminho é /bigquery/v2/.

    2. Para o destino RFC que se conecta ao BigQuery, verifique se o valor do campo Target Host é bigquery.googleapis.com.

    3. Para o destino RFC que se conecta ao IAM, verifique se o valor do campo Prefixo do caminho é /v1/.

    4. Para o destino RFC que se conecta ao IAM, verifique se o valor do campo Target Host é iamcredentials.googleapis.com.

  6. Execute novamente a replicação ou o carregamento inicial.

Problema: /GOOG/MSG : 401 - Unauthorized Request is missing required authentication credential. Expected OAuth 2 access to ken, login coo

Problema: falha na transferência de dados com a mensagem de erro /GOOG/MSG : 401 - Unauthorized Request is missing required authentication credential. Expected OAuth 2 access to ken, login coo.

Causa: não há configuração da porta HTTP.

Resolução: as portas HTTP e HTTPS precisam ser criadas e estar ativas no sistema SAP.

Os metadados da VM são armazenados em um servidor de metadados, que só pode ser acessado por uma porta HTTP. Portanto, é preciso garantir que uma porta HTTP, junto com uma porta HTTPS, seja criada e esteja ativa para acessar os metadados da VM.

Para resolver esse problema, siga estas etapas:

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

  2. Na barra de menus, clique em Ir para > Serviços.

  3. Verifique se as portas HTTP e HTTPS foram criadas e estão ativas. Uma marca de seleção verde na coluna Actv indica que as portas HTTP e HTTPS estão ativadas.

  4. Execute a replicação novamente.

Para informações sobre como configurar as portas HTTP e HTTPS, consulte Configurações de HTTP(S) no ICM.

Problema: /GOOG/MSG : 401 - ICM_HTTP_CONNECTION_BROKEN

Problema: durante o carregamento ou a replicação inicial, na transação LTRC, a transferência de dados falhava com a mensagem de erro /GOOG/MSG : 401 - ICM_HTTP_CONNECTION_BROKEN.

Causa: para sua carga de trabalho SAP em execução no Google Cloud, nos destinos RFC que o BigQuery Connector para SAP usa para se conectar às APIs do Google Cloud, O SSL não é ativado.

Resolução: para resolver esse problema, siga estas etapas:

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

    /n/GOOG/SLT_SETTINGS

  2. Para o ID de transferência em massa que falhou na transação LTRC, anote o valor do campo Nome da chave do Google Cloud.

  3. Insira a transação SM30 e abra a tabela /GOOG/SERVIC_MAP.

  4. Para o valor Nome de chave do Google Cloud que você anotou em uma etapa anterior, anote os nomes de destino do RFC.

  5. Insira a transação SM59 e, em seguida, para os destinos de RFC anotados na etapa anterior, execute as etapas a seguir:

    1. Acesse a guia Login e segurança.

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

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

  6. Execute a replicação novamente.

Problema /GOOG/MSG: 110 - HTTPIO_PLG_CANCELED

Problema: durante o carregamento ou a replicação inicial, na transação LTRC, a transferência de dados falhava com a mensagem de erro /GOOG/MSG: 110 - HTTPIO_PLG_CANCELED.

Causa: não há configuração da porta HTTP.

Resolução: as portas HTTP e HTTPS precisam ser criadas e estar ativas no sistema SAP.

Os metadados da VM são armazenados em um servidor de metadados, que só pode ser acessado por uma porta HTTP. Portanto, é preciso garantir que uma porta HTTP, junto com uma porta HTTPS, seja criada e esteja ativa para acessar os metadados da VM.

Para resolver esse problema, siga estas etapas:

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

  2. Na barra de menus, clique em Ir para > Serviços.

  3. Verifique se as portas HTTP e HTTPS foram criadas e estão ativas. Uma marca de seleção verde na coluna Actv indica que as portas HTTP e HTTPS estão ativadas.

  4. Execute a replicação novamente.

Para informações sobre como configurar as portas HTTP e HTTPS, consulte Configurações de HTTP(S) no ICM.

Problema: /GOOG/MSG: 403 - SSL is required to perform this operation

Problema: falha na transferência de dados com a mensagem de erro /GOOG/MSG: 403 - SSL is required to perform this operation.

Causa: para sua carga de trabalho SAP em execução no Google Cloud, nos destinos RFC que o BigQuery Connector para SAP usa para se conectar às APIs do Google Cloud, O SSL não é ativado.

Resolução: para resolver esse problema, siga estas etapas:

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

    /n/GOOG/SLT_SETTINGS

  2. Para o ID de transferência em massa que falhou na transação LTRC, anote o valor do campo Nome da chave do Google Cloud.

  3. Insira a transação SM30 e abra a tabela /GOOG/SERVIC_MAP.

  4. Para o valor Nome de chave do Google Cloud que você anotou em uma etapa anterior, anote os nomes de destino do RFC.

  5. Insira a transação SM59 e, em seguida, para os destinos de RFC anotados na etapa anterior, execute as etapas a seguir:

    1. Acesse a guia Login e segurança.

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

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

  6. Execute a replicação novamente.

Problema: /GOOG/MSG: 403 - Request had insufficient authentication scopes

Problema: falha na transferência de dados com a mensagem de erro /GOOG/MSG: 403 - Request had insufficient authentication scopes.

Causa: para a carga de trabalho SAP em execução no Google Cloud, na tabela /GOOG/CLIENT_KEY, a conta de serviço especificada não tem o escopo necessário para acessar o BigQuery.

Resolução: para resolver esse problema, siga estas etapas:

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

    /n/GOOG/SLT_SETTINGS

  2. Para o ID de transferência em massa que falhou na transação LTRC, anote o valor do campo Nome da chave do Google Cloud.

  3. Insira a transação SM30 e abra a tabela /GOOG/CLIENT_KEY.

  4. Para o valor Nome da chave do Google Cloud que você anotou em uma etapa anterior, verifique se o valor especificado para o campo Nome da conta de serviço é default.

  5. No console do Google Cloud, acesse a página Instâncias de VM do Compute Engine.

    Acessar instâncias de VM

  6. Clique na instância da VM que hospeda o servidor de replicação de SAP LT.

  7. Clique em Parar e siga as instruções para interromper a instância de VM.

  8. Clique em Editar, edite os escopos de acesso da conta de serviço para permitir o acesso ao BigQuery e clique em Salvar.

  9. Clique em Iniciar / Retomar para reiniciar a VM.

  10. Confirme se o servidor de replicação do SAP LT está em execução.

  11. Execute a replicação novamente.

Problema: /GOOG/MSG: 403 - Access Denied: Dataset PROJECT_ID:DATASET_NAME: Permission bigquery.tables.created denied on dataset

Problema: falha na transferência de dados com a mensagem de erro /GOOG/MSG: 403 - Access Denied: Dataset PROJECT_ID:DATASET_NAME: Permission bigquery.tables.created denied on dataset.

Causa: na carga de trabalho SAP em execução no Google Cloud, na tabela /GOOG/CLIENT_KEY, a conta de serviço especificada não tem as permissões necessárias para acessar a API BigQuery.

Resolução: para resolver esse problema, siga estas etapas:

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

    /n/GOOG/SLT_SETTINGS

  2. Para o ID de transferência em massa que falhou na transação LTRC, anote o valor do campo Nome da chave do Google Cloud.

  3. Insira a transação SM30 e abra a tabela /GOOG/CLIENT_KEY.

  4. Para o valor do Nome da chave do Google Cloud que você anotou em uma etapa anterior, anote o valor especificado no campo Nome da conta de serviço.

  5. No console do Google Cloud, acesse a página Contas de serviço do Identity and Access Management.

    Acessar Contas de serviço

  6. Selecione a conta de serviço que você anotou em uma etapa anterior.

  7. Verifique se a conta de serviço tem os papéis do IAM que o BigQuery Connector para SAP precisa para acessar o BigQuery, conforme fornecido no Google Cloud Identity and Access Management.

  8. Execute a replicação novamente.

Problema: /GOOG/MSG: 404 - Not Found

Problema: falha na transferência de dados com a mensagem de erro /GOOG/MSG: 404 - Not Found.

Causa: nos destinos RFC que o BigQuery Connector para SAP usa para se conectar às APIs do Google Cloud, o prefixo do caminho não está correto.

Resolução: para resolver esse problema, siga estas etapas:

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

    /n/GOOG/SLT_SETTINGS

  2. Para o ID de transferência em massa que falhou na transação LTRC, anote o valor do campo Nome da chave do Google Cloud.

  3. Insira a transação SM30 e abra a tabela /GOOG/SERVIC_MAP.

  4. Para o valor Nome de chave do Google Cloud que você anotou em uma etapa anterior, anote os nomes de destino do RFC.

  5. Insira a transação SM59 e siga estas etapas:

    • Para o destino RFC que se conecta ao BigQuery, verifique se o valor do campo Prefixo do caminho é /bigquery/v2/.
    • Para o destino RFC que se conecta ao IAM, verifique se o valor do campo Prefixo do caminho é /v1/.

  6. Execute a replicação novamente.

Problema: /GOOG/MSG: 404 - Table PROJECT_ID:DATASET_NAME.TABLE_NAME not found

Problema: falha na transferência de dados com a mensagem de erro /GOOG/MSG: 404 - Table PROJECT_ID:DATASET_NAME.TABLE_NAME not found.

Causa: nos destinos RFC que o BigQuery Connector para SAP usa para se conectar às APIs do Google Cloud, o valor especificado para o campo Host de destino não corresponde a nenhum nome de DNS no Cloud DNS.

Resolução: para resolver esse problema, siga estas etapas:

  1. Na GUI do SAP, insira o código da transação SE38 e abra o relatório /GOOG/R_SLT_SETTINGS.

  2. Para a transação LTRC que foi executada, abra o ID de transferência em massa e anote o valor na coluna Nome da chave do Google Cloud.

  3. Insira a transação SM30 e abra a tabela /GOOG/CLIENT_KEY no modo de exibição.

  4. Pesquise a tabela /GOOG/SERVIC_MAP usando o nome da chave do Google Cloud que você anotou em uma etapa anterior. Em seguida, anote os nomes de destino RFC especificados.

  5. Insira o código da transação SM59.

  6. Para os destinos da RFC usados para se conectar às APIs do BigQuery e do IAM, anote o valor especificado no campo Host de destino.

  7. No console do Google Cloud, acesse a página Cloud DNS de serviços de rede.

    Acessar Cloud DNS

  8. Clique na zona particular que contém os registros DNS dos endpoints do Private Service Connect, criados para permitir que o BigQuery Connector para SAP se conecte de forma particular às APIs do BigQuery e do IAM.

  9. Verifique se há um registro DNS, com nome DNS correspondente para cada um dos valores de host de destino que você anotou em uma etapa anterior.

  10. Execute a replicação novamente.

Problema: /GOOG/MSG: 404 - Not Found Requested entity was not found

Problema: falha na transferência de dados com a mensagem de erro /GOOG/MSG: 404 - Not Found Requested entity was not found.

Causa: para a carga de trabalho em execução no Google Cloud, a conta de serviço usada na tabela de chaves do cliente /GOOG/CLIENT_KEY não é válida.

Resolução: para resolver esse problema, siga estas etapas:

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

    /n/GOOG/SLT_SETTINGS

  2. Para o ID de transferência em massa que falhou na transação LTRC, anote o valor do campo Nome da chave do Google Cloud.

  3. Insira a transação SM30 e abra a tabela /GOOG/CLIENT_KEY.

  4. No campo Nome da conta de serviço, verifique se o valor especificado é o endereço de e-mail da conta de serviço que foi criada para o BigQuery Connector para SAP na etapa Criar uma conta de serviço.

  5. Execute a replicação novamente.

Problema: /GOOG/MSG: 418 - Falha na transferência de dados com uma mensagem de erro do SAP

Problema: falha na transferência de dados com uma mensagem de erro do SAP, por exemplo, No OS command defined for the key.

Causa: para a carga de trabalho SAP que não está em execução no Google Cloud, esse problema pode ser causado pelas circunstâncias a seguir:

O comando do SO que imprime o token de acesso não está configurado corretamente

Causas: este problema pode ser causado pelas circunstâncias a seguir:

  • Você criou um comando do sistema operacional (SO) para imprimir o token de acesso, mas ele não foi adicionado às configurações de acesso na tabela de chaves do cliente /GOOG/CLIENT_KEY.

  • O comando do SO criado na transação SM69 não conseguiu recuperar um token de acesso do Google Cloud.

Resolução: na tabela de chaves do cliente /GOOG/CLIENT_KEY, no campo Nome do comando, verifique se o valor inserido corresponde ao nome do comando que você criou para imprimir o token de acesso.

O RFC não está configurado corretamente

Causa: para sua carga de trabalho SAP em execução no Google Cloud, nos destinos RFC que o BigQuery Connector para SAP usa para se conectar às APIs do Google Cloud, o valor do campo Host de destino estiver incorreto.

Resolução: para resolver esse problema:

  1. Na GUI do SAP, insira a transação SE38 e abra o relatório /GOOG/R_SLT_SETTINGS.

  2. Para a transação LTRC que foi executada, abra o ID de transferência em massa e anote o valor de Nome da chave do Google Cloud.

  3. Insira a transação SM30 e abra a tabela /GOOG/CLIENT_KEY no modo de exibição.

  4. Pesquise a tabela /GOOG/SERVIC_MAP usando o nome da chave do Google Cloud que você anotou em uma etapa anterior. Em seguida, anote os nomes de destino RFC especificados.

  5. Insira o código da transação SM59 e abra os destinos do RFC que você anotou na etapa anterior.

  6. No campo Host de destino, corrija o URL especificado.

  7. Execute a replicação novamente.

Problema: /GOOG/MSG: 413 - Request Entity Too Large

Problema: falha na transferência de dados com a mensagem de erro /GOOG/MSG: 413 - Request Entity Too Large.

Causa: esse problema pode ser causado quando o tamanho de bytes do bloco enviado pelo BigQuery Connector para SAP excede o tamanho máximo de bytes das solicitações HTTP aceitas pelo BigQuery. Isso pode ocorrer quando o tamanho dos registros da tabela ou a quantidade de dados que eles contêm faz com que o tamanho do byte de um bloco aumente além do limite do BigQuery.

Resolução: reduza o tamanho dos blocos que são enviados pelo BigQuery Connector para SAP para a tabela. É possível ajustar o tamanho do bloco executando a transação /GOOG/SLT_SETTINGS ou ativar o tamanho dinâmico do bloco para ajustar automaticamente o tamanho do bloco. Veja mais informações em:

Problema: /GOOG/MSG: 503 - HTTP Communication Failure - SSL client SSL Client (Standard)

Problema: falha na transferência de dados com a mensagem de erro /GOOG/MSG: 503 - HTTP Communication Failure - SSL client SSL Client (Standard).

Causa: para sua carga de trabalho SAP em execução no Google Cloud, nos destinos RFC que o BigQuery Connector para SAP usa para se conectar às APIs do Google Cloud, o valor do campo Host de destino estiver incorreto.

Resolução: para resolver esse problema, consulte as etapas de resolução em O RFC não está configurado corretamente.

Problema: /GOOG/MSG: 503 - HTTP Communication Failure exception occurred during the request sending

Problema: falha na transferência de dados com a mensagem de erro /GOOG/MSG: 503 - HTTP Communication Failure exception occurred during the request sending.

Causa: isso pode ser causado por problemas de conexão ou de rede.

Resolução: valide sua conexão e verifique se a rede está configurada corretamente, em execução sem erros e se não está congestionada.

Problema: /GOOG/MSG: 503 - HTTP Communication Failure exception occurred during the response receiving

Problema: falha na transferência de dados com a mensagem de erro /GOOG/MSG: 503 - HTTP Communication Failure exception occurred during the response receiving.

Esse problema pode ser causado pelas seguintes circunstâncias:

O SSL não está ativado nos seus destinos de RFC

Causa: nos destinos RFC que o BigQuery Connector para SAP usa para se conectar às APIs do Google Cloud, a opção de segurança para usar o certificado SSL não está ativada.

Resolução: para resolver esse problema, consulte as etapas de resoluções em Problema: /GOOG/MSG: 403 - SSL é necessário para executar esta operação.

Falha no handshake de SSL

Causa: quando o handshake de SSL falhou entre o host do servidor de replicação do LT SAP e do endpoint da API BigQuery. Isso ocorre quando o certificado apresentado pelo servidor TLS não é válido para o nome do host de destino fornecido pelo servidor de replicação do LT SAP, possivelmente porque o envio do lado do cliente da extensão SNI do TLS opcional não é implementado no kernel do NetWeaver.

Resolução: na transação SMICM, procure o código de retorno, SSLERR_SERVER_CERT_MISMATCH. Se você encontrar o código de retorno SSLERR_SERVER_CERT_MISMATCH, será necessário ativar o envio da extensão SNI do TLS. Além disso, verifique se o kernel do NetWeaver implementa o envio do lado do cliente da extensão SNI do TLS opcional.

Para ativar o envio de SNI da extensão TLS, defina o parâmetro de perfil icm/HTTPS/client_sni_enabled ou ssl/client_sni_enabled como TRUE, dependendo da versão do kernel do NetWeaver. Para mais informações da SAP, consulte os links a seguir:

O tamanho de bytes dos blocos excedeu o tamanho máximo de bytes das solicitações HTTP aceitas pelo BigQuery

Causa: quando o tamanho de bytes do bloco enviado pelo BigQuery Connector para SAP excedeu o tamanho máximo de bytes das solicitações HTTP aceitas pelo BigQuery. Isso pode ocorrer quando o tamanho dos registros da tabela ou a quantidade de dados que eles contêm faz com que o tamanho do byte de um bloco aumente além do limite do BigQuery.

Resolução: reduza o tamanho dos blocos que são enviados pelo BigQuery Connector para SAP para essa tabela. É possível ajustar o tamanho do bloco executando a transação /GOOG/SLT_SETTINGS ou ativar o tamanho dinâmico do bloco para ajustar automaticamente o tamanho do bloco. Veja mais informações em:

Problema: /GOOG/MSG: 404 - Not found: Dataset DATASET_NAME

Problema: ao tentar validar a segurança do Google Cloud ou carregar dados em uma tabela do BigQuery, você recebe a mensagem /GOOG/MSG: 404 - Not found: Dataset DATASET_NAME.

Causa:este problema pode ser causado pelas seguintes circunstâncias:

  • O conjunto de dados do BigQuery ainda não foi criado.
  • O nome do conjunto de dados não foi especificado corretamente na configuração da transferência em massa.
  • A configuração de replicação no SAP LT Replication Server precisa ser ativada.

Resolução: tente as seguintes resoluções:

  • Confirme se o conjunto de dados foi criado no BigQuery.
  • Verifique se o nome do conjunto de dados na configuração da transferência em massa é o mesmo do nome do conjunto de dados no BigQuery.
  • Execute a transação LTRC e desative e reative a configuração de replicação.

Problema: Mass Transfer Key can not be found for Mass Transfer ID XXX

Problema: você recebe o erro /GOOG/SLT: Mass Transfer Key can not be found for Mass Transfer ID XXX.

Causa:este problema pode ser causado pelas seguintes circunstâncias:

  • Não existe uma configuração de transferência em massa para o ID especificado.
  • A configuração de replicação correspondente não está ativa.

Resolução: para resolver o problema, execute uma das seguintes ações:

  • Execute a transação /GOOG/SLT_SETTINGS e confirme se o ID da transferência em massa foi especificado corretamente.
  • Execute a transação LTRC e desative e reative a configuração de replicação.

Problema: /GOOG/SLT : Unable to interpret VALUE as a BOOLEAN

Problema: o carregamento ou a replicação de um registro falha com a mensagem /GOOG/SLT : Unable to interpret VALUE as a BOOLEAN.

Causa: esse problema é causado pelo mapeamento de um campo na tabela de origem para o tipo de dados do BigQuery BOOLEAN, mas os dados no campo de origem não são resolvidos para um booleano.

Resolução: para resolver o problema, use a transação /GOOG/SLT_SETTINGS para alterar o tipo de dados ao qual o campo de origem está mapeado ou remover o mapeamento do tipo de dados e aceitar o tipo de dados padrão.

Problema: /GOOG/SLT: Failed to convert field SAP_FIELD_NAME value to field BIGQUERY_FIELD_NAME: ERROR_DETAILS

Problema: o carregamento ou a replicação de um registro falha com a mensagem /GOOG/SLT: Failed to convert field SAP_FIELD_NAME value to field BIGQUERY_FIELD_NAME: ERROR_DETAILS.

Causa: o campo de origem contém um valor inválido ou o campo de origem é mapeado para um tipo de dados do BigQuery que não é um mapeamento válido para os dados que o campo de origem contém.

Resolução: para resolver o problema, use a transação /GOOG/SLT_SETTINGS para alterar o tipo de dados ao qual o campo de origem está mapeado ou remover o mapeamento do tipo de dados e aceitar o mapeamento padrão para o tipo de dados.

Problema: /GOOG/MSG : Client key is not found in /GOOG/CLIENT_KEY table

Problema: um carregamento ou replicação não começa com a mensagem /GOOG/MSG: Client key is not found in /GOOG/CLIENT_KEY table.

Causa: a chave do cliente não existe ou foi especificada incorretamente na configuração de transferência em massa da transação /GOOG/SLT_SETTINGS.

Resolução: para resolver o problema, use a transação SM30 para criar a chave do cliente ou use a transação /GOOG/SLT_SETTINGS para corrigir a especificação do valor da chave do cliente no configuração de transferência em massa.

Problema: /GOOG/MSG: DESCRIPTION_OF_ISSUE error occurred in chunk ranging START_INDEX_OF_FAILED_CHUNK - END_INDEX_OF_FAILED_CHUNK

Problema: falha na replicação de um bloco com uma mensagem de erro /GOOG/MSG: DESCRIPTION_OF_ISSUE error occurred in chunk ranging START_INDEX_OF_FAILED_CHUNK - END_INDEX_OF_FAILED_CHUNK.

Causa: pode ter mais de uma causa, incluindo Invalid JSON Payload, Quota Exceeded, Request Entity Too Large ou HTTP Communication Failure. A mensagem de erro para o bloco que não foi replicada para o BigQuery é exibida com o índice de início e fim.

Essa mensagem de erro vai aparecer se você não tiver definido a sinalização BREAK na transação /GOOG/SLT_SETTINGS. Quando a sinalização BREAK não está definida, o BigQuery Connector para SAP continua enviando registros para o BigQuery enviando o próximo bloco, mesmo quando um erro é encontrado.

Resolução: tente as resoluções a seguir:

Problema: DESCRIPTION_OF_ISSUE while signing JWT using profile KEY_FILE_NAME.pse. Check JWT config in STRUST

Problema: você recebe o erro DESCRIPTION_OF_ISSUE while signing JWT using profile KEY_FILE_NAME .pse. Check JWT config in STRUST.

Causa: as configurações do JWT e da chave da conta de serviço não estão definidas corretamente no STRUST.

Resolução: confirme se a configuração do JWT e a chave da conta de serviço estão definidas conforme explicado em Autenticação usando JWT para receber tokens de acesso.

Problema: Bad Request invalid_grant. Invalid JWT Signature

Problema: você recebe o erro Bad Request invalid_grant. Invalid JWT Signature.

Causa: o arquivo de chave PSE ou P12 importado para STRUST não pertence à conta de serviço que você usou para assinar o JWT.

Resolução: importe o arquivo de chave de conta de serviço correto para STRUST. Para informações sobre como importar a chave da conta de serviço para STRUST, consulte Importar a chave da conta de serviço para STRUST.

Problema: /GOOG/MSG : 400 - Bad Request invalid_grant Invalid grant: account not found

Problema: não é possível se conectar às APIs do Google Cloud.

Causa: a conta de serviço usada para assinar o JWT está incorreta ou não tem as permissões necessárias.

Solução: verifique se a conta de serviço especificada para a recuperação de token baseada em JWT está corretamente mantida em relação ao parâmetro JWT_SERVC_ACCT na tabela /GOOG/BQ_PARAM. Para mais informações, consulte Ativar a assinatura JWT para a conta de serviço no host do SAP LT Replication Server.

Problema: OAuth RFC HTTP Destination not maintained in /GOOG/SERVIC_MAP

Problema: você recebe o erro OAuth RFC HTTP Destination not maintained in /GOOG/SERVIC_MAP.

Causa: o destino do RFC para o OAuth 2.0 não está disponível na tabela de mapeamento de serviço /GOOG/SERVIC_MAP.

Resolução: atualize o destino RFC para o OAuth 2.0 na tabela de mapeamento de serviço /GOOG/SERVIC_MAP e execute novamente a carga. Para saber mais sobre como especificar destinos RFC, consulte Especificar destinos RFC em /GOOG/SERVIC_MAP.

Problema: para idiomas de logon diferentes do inglês, as descrições de campo ficam truncadas quando você faz o upload de dados usando um arquivo CSV.

Problema: para idiomas de logon que não são o inglês, quando você faz o upload dos tipos de campo da tabela de destino do BigQuery e das descrições de campo usando a opção de upload de arquivo, as descrições de campo do arquivo CSV não são enviados de maneira precisa. Você vai encontrar caracteres e símbolos distorcidos nas descrições enviadas.

Causa: para idiomas de logon diferentes do inglês, o utilitário de upload de arquivos não consegue interpretar com precisão os caracteres no arquivo CSV.

Resolução: para fazer upload dos tipos e descrições de campos da tabela de destino do BigQuery em um idioma diferente do inglês, use o formato de codificação UTF-8 com a marca de ordem de byte (BOM, na sigla em inglês) para o arquivo CSV. Salve o arquivo CSV em UTF-8 com o formato BOM e faça upload do arquivo.

Problemas operacionais comuns

Nesta seção, você verá resoluções para problemas comuns que podem ocorrer após a configuração inicial do BigQuery Connector para SAP.

Problema: tabelas de origem vazias no SAP não são criadas no conjunto de dados do BigQuery

Problema: tabelas de origem vazias no SAP não são criadas no conjunto de dados do BigQuery

Causa: para tabelas de origem vazias no SAP, o SAP SLT impede a criação de tabelas de destino no BigQuery.

Resolução: para criar tabelas de destino no conjunto de dados do BigQuery para tabelas de origem vazias no SAP, use a ferramenta Criar tabela. Para mais informações sobre a execução da ferramenta Criar tabela, consulte Ferramenta Criar tabela.

Problema: número incorreto de gravações no BigQuery

Problema: o número de registros gravados no BigQuery é maior do que o número de registros mostrados nos registros do servidor SAP LT Replication.

Causa: pode ter mais de uma causa, incluindo problemas de conexão transitórios que fazem com que o SAP LT Replication Server envie registros mais de uma vez ou o fato de que a tabela do BigQuery aceita apenas inserções, e cada alteração em um único registro na origem é inserida como uma entrada separada na tabela de destino.

Resolução: se a diferença nas contagens de registro não for extrema e não houver menos registros no BigQuery do que na tabela de origem, esse é o comportamento esperado, sem problema.

Para reconciliar com precisão o número de registros no BigQuery com o número de registros na tabela de origem, consulte a tabela do BigQuery conforme descrito em Consultas SQL para contagens de registros.

Para mais informações sobre as possíveis causas desse problema, consulte Considerações especiais para origens/destinos de ABAP no HANA.

Problema: /GOOG/MSG : 400 - Schema mismatch for table TABLE_NAME

Problema: você recebe a mensagem de erro /GOOG/MSG : 400 - Schema mismatch for table TABLE_NAME. Please delete the table from BigQuery and try again.

Causa: uma das seguintes alterações foi inserida em uma tabela existente do BigQuery:

  • Exclusão de um campo
  • Como renomear um campo
  • Alteração no tipo de dados de um campo
  • Alteração no tipo de partição de uma tabela

As mudanças anteriores não podem ser aplicadas a uma tabela atual do BigQuery.

Resolução: se você precisar alterar qualquer um desses atributos de campo em uma tabela atual, será necessário excluir a tabela atual e recarregar os registros em uma nova tabela.

Se a alteração foi um erro, reverta a alteração no SAP LT Replication Server.

Para mais informações sobre como configurar campos e partições em uma tabela de destino do BigQuery, consulte Configurações de replicação do BigQuery.

Problema: mensagens de erro relacionadas a dados inválidos

Problema: nos registros do aplicativo, você recebe uma mensagem de erro: /GOOG/MSG/: DESCRIPTION_OF_INVALID_DATA error occurred in FIELD_NAME in record RECORD_KEYS.

Causa: essa mensagem de erro é emitida pelo BigQuery ao inserir os registros com dados inválidos na tabela de destino. Os dados podem ser inválidos por um dos seguintes motivos:

  • Os dados no campo de um registro específico não são compatíveis com o tipo de dados no BigQuery. Por exemplo, o BigQuery gera mensagens de erro quando:
    • Uma string é mantida em um campo do tipo DATE, INTEGER ou BOOLEAN.
    • Uma data inválida (00/00/0000) é mantida em um campo do tipo DATE.
  • Um tipo de dados de destino incorreto é mantido nos mapeamentos de campo na transação /GOOG/SLT_SETTINGS.

Uma mensagem de erro é emitida pelo BigQuery para cada registro que contém um campo com dados inválidos.

Resolução: analise a mensagem de erro DESCRIPTION_OF_INVALID_DATA para entender a possível causa para dados inválidos. Para identificar o registro com o campo que contém os dados inválidos, use RECORD_KEYS, que inclui o conteúdo dos cinco primeiros campos do registro. Se a tabela tiver cinco campos ou menos, o conteúdo de todos os campos será incluído no RECORD_KEYS.

  • Se os dados no campo não forem compatíveis com o tipo de dados no BigQuery, corrija-os na tabela de origem.
  • Se o erro tiver ocorrido devido a uma incompatibilidade entre os dados e o tipo de dados, use a transação /GOOG/SLT_SETTINGS para especificar um tipo de dados apropriado. Para mais informações sobre o mapeamento do tipo de dados, consulte Mapeamento do tipo de dados.

Problema: o valor de um campo exibido na transação SE16 ou SE16N é diferente do valor exibido no BigQuery

Problema: em alguns casos, o valor de um campo exibido na transação SE16 ou SE16N é diferente do valor mostrado no BigQuery.

Causa: no sistema de origem SAP S/4HANA, tabelas como MARD, MARC, MBEW e MBEWH têm visualizações de compatibilidade que exibem valores na transação SE16 ou SE16N. Para essas tabelas, os valores exibidos na transação SE16 ou SE16N são calculados nas visualizações de compatibilidade usando condições de mesclagem, que incluem várias outras tabelas.

Quando uma tabela com uma visualização de compatibilidade é configurada no SLT para replicação no BigQuery, o SLT não replica os dados da visualização de compatibilidade. Em vez disso, ele replica os dados de cada uma das tabelas subjacentes separadamente e, portanto, você pode notar que alguns campos têm valores diferentes em SE16 ou em SE16N em comparação ao que é mostrado no BigQuery. Esse é um comportamento padrão do SLT.

Resolução: para resolver o problema, siga estas etapas:

  1. Na GUI do SAP, insira o código da transação LTRS.
  2. Selecione as configurações de transferência em massa para a replicação do BigQuery.
  3. Acesse Configurações avançadas de replicação > Configurações da tabela.
  4. Selecione a tabela que usa visualizações de compatibilidade. Se a tabela necessária não estiver listada, adicione-a.

  5. Na seção Configurações de processamento, insira valores nos seguintes campos:

    • Visualização para carga inicial: o valor da visualização de compatibilidade para a tabela de SE16 ou SE16N.
    • Visualização para replicação: o valor da visualização de compatibilidade para a tabela de SE16 ou SE16N.

  6. Salve as configurações.

Como alternativa, replique todas as tabelas da visualização de compatibilidade no BigQuery. No BigQuery, mescle essas tabelas usando as mesmas condições de mesclagem da visualização de compatibilidade.

Para mais informações da SAP sobre algumas tabelas conhecidas e as visualizações de compatibilidade delas, consulte a Nota SAP 2595627: O acesso à tabela do SE16/SE16N mostra resultados diferentes no banco de dados SAP HANA.

Problema: Failed to create proxy table TARGET_TABLE_NAME for object SOURCE_TABLE_NAME

Problema: ao transferir dados do SAP HANA para o BigQuery usando o BigQuery Connector para SAP, o carregamento da tabela falhou com a mensagem de erro Failed to create proxy table TARGET_TABLE_NAME for object SOURCE_TABLE_NAME.

Causa: o número de caracteres em um ou mais campos da tabela de origem excede a restrição de 30 caracteres definida pelo SLT.

Resolução: tente as seguintes resoluções:

  • Se o número de caracteres nos campos-chave de uma tabela ultrapassar 30, não será possível carregar ou replicar essas tabelas. Essa é uma limitação conhecida do SLT.
  • Se o número de caracteres em outros campos de uma tabela ultrapassar 30, crie uma visualização para associar os nomes dos campos com mais de 30 caracteres a nomes mais curtos.

Para mais informações, consulte a Nota SAP 1768805: Servidor de replicação de transformação de paisagem (SLT) do SAP: fontes não baseadas em ABAP.

Receber suporte

Se você precisar de ajuda para resolver problemas de replicação e do BigQuery Connector para SAP, colete todas as informações de diagnóstico disponíveis e entre em contato com o Cloud Customer Care.

Para mais informações sobre como entrar em contato com o Cloud Customer Care, consulte Como receber suporte para a SAP no Google Cloud.