Esta página foi traduzida pela API Cloud Translation.

Solução de problemas do BigQuery Toolkit para SAP

Este documento mostra aos administradores da SAP, aos desenvolvedores da SAP ou a outras pessoas como resolver problemas com o BigQuery Toolkit para SAP.

Problemas comuns

Esta seção lista mensagens de erro comuns e a resolução delas específica para o BigQuery Toolkit para SAP.

Para informações sobre a solução de problemas do SDK do ABAP para Google Cloud em geral, consulte Solução de problemas no local ou em qualquer edição na nuvem do SDK do ABAP para Google Cloud.

`/GOOG/BQTR: Mass Transfer Key is required. Use Tcode /GOOG/BQTR_SETTINGS to maintain`

Problema: falha na transferência de dados com a mensagem de erro /GOOG/BQTR: Mass Transfer Key is required. Use Tcode /GOOG/BQTR_SETTINGS to maintain.

Causa:a chave de transferência em massa não é fornecida no parâmetro IV_MASS_TR_KEY ao chamar a classe de carregamento de dados /GOOG/CL_BQTR_DATA_LOAD.

Resolução:para resolver esse problema, transmita uma chave de transferência em massa que seja salva na transação /GOOG/BQTR_SETTINGS. Para mais informações, consulte Chamar o método de replicação de dados.

`/GOOG/BQTR: Data Source is required. Pass a dictionary object`

Problema: falha na transferência de dados com a mensagem de erro /GOOG/BQTR: Data Source is required. Pass a dictionary object.

Causa:a fonte de dados não é fornecida no parâmetro IV_DATA_SOURCE ao chamar a classe de carregamento de dados /GOOG/CL_BQTR_DATA_LOAD.

Solução:para resolver esse problema, transmita o nome do objeto de dicionário, como a visualização ou tabela do CDS, como a fonte de dados. Para mais informações, consulte Chamar o método de replicação de dados.

`/GOOG/BQTR: Mass Transfer Key MASS_TRANSFER_KEY not found. Use Tcode /GOOG/BQTR_SETTINGS to maintain`

Problema: falha na transferência de dados com a mensagem de erro /GOOG/BQTR: Mass Transfer Key MASS_TRANSFER_KEY not found. Use Tcode /GOOG/BQTR_SETTINGS to maintain.

Causa:a chave de transferência em massa transmitida à classe de carregamento de dados /GOOG/CL_BQTR_DATA_LOAD não é mantida no módulo de transferência de dados do BigQuery.

Resolução:para resolver esse problema, mantenha uma chave de transferência em massa usando o código de transação /GOOG/BQTR_SETTINGS. Para mais informações, consulte Configurar o módulo de transferência de dados do BigQuery.

`/GOOG/BQTR: DATA_SOURCE does not exist in data dictionary`

Problema: falha na transferência de dados com a mensagem de erro /GOOG/BQTR: DATA_SOURCE does not exist in data dictionary.

Causa:a fonte de dados transmitida à classe de carregamento de dados /GOOG/CL_BQTR_DATA_LOAD não é um objeto de dicionário de dados válido.

Solução:para resolver esse problema, transmita o nome da fonte de dados que existe no dicionário de dados. Somente tabelas, visualizações de dicionário e visualizações do CDS são aceitas.

`/GOOG/BQTR: Nested Tables are not supported`

Problema:você recebe a mensagem de erro /GOOG/BQTR: Nested Tables are not supported.

Causa:o objeto de dicionário transmitido como entrada para a classe de carregamento de dados /GOOG/CL_BQTR_DATA_LOAD não é uma estrutura simples.

Solução:para resolver esse problema, use um objeto de dicionário com uma estrutura simples.

`/GOOG/BQTR: Error creating target table definition`

Problema:você recebe a mensagem de erro /GOOG/BQTR: Error creating target table definition.

Causa:o BigQuery Toolkit para SAP não consegue criar a definição da tabela de destino para a fonte de dados especificada.

Solução:para resolver esse problema, valide se a origem de entrada é um objeto de dicionário válido com um ou mais campos.

`/GOOG/BQTR: 400 - Table creation failed in BQ. Could not pull the table metadata from BQ`

Problema:você recebe a mensagem de erro /GOOG/BQTR: 400 - Table creation failed in BQ. Could not pull the table metadata from BQ.

Causa:esse erro é gerado se o módulo de transferência de dados do BigQuery não conseguir acessar a definição da tabela no BigQuery. Isso pode ser causado por uma sobrecarga temporária do servidor no BigQuery.

Solução:para resolver esse problema, reinicie a operação de carregamento de dados do BigQuery.

`/GOOG/BQTR: 400 - Scope must be provided`

Problema:você recebe a mensagem de erro /GOOG/BQTR: 400 - Scope must be provided.

Causa:na configuração da chave do cliente, o escopo do Google Cloud está vazio.

Resolução:para resolver esse problema, na configuração da chave do cliente que você está usando, especifique o escopo correspondente no campo Escopo do Google Cloud. Por exemplo, https://www.googleapis.com/auth/cloud-platform.

`/GOOG/BQTR: 400 - Schema mismatch for table TABLE_NAME`

Problema:você recebe a mensagem de erro /GOOG/BQTR: 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.

Mensagens de erro relacionadas a dados inválidos

Problema: nos registros do aplicativo, você recebe uma mensagem de erro: /GOOG/BQTR/: 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/BQTR_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/BQTR_SETTINGS para especificar um tipo de dados apropriado.

`/GOOG/BQTR: 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/BQTR: 403 - Access Denied: Dataset PROJECT_ID:DATASET_NAME: Permission bigquery.tables.created denied on dataset.

Causa:na carga de trabalho SAP em execução em 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:

Na GUI do SAP, insira a transação /GOOG/BQTR_SETTINGS precedida por /n:
```
/n/GOOG/BQTR_SETTINGS
```
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.
Insira a transação SM30 e abra a tabela /GOOG/CLIENT_KEY.
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.
No console do Google Cloud, acesse a página Contas de serviço do Identity and Access Management.

Acesse as Contas de serviço
Selecione a conta de serviço que você anotou em uma etapa anterior.
Verifique se a conta de serviço tem os papéis do IAM que o BigQuery Toolkit para SAP precisa para acessar o BigQuery, conforme fornecido em Configurar a autenticação.
Execute a replicação novamente.

`/GOOG/BQTR: 404 - Not Found`

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

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

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

Na GUI do SAP, insira a transação /GOOG/BQTR_SETTINGS precedida por /n:
```
/n/GOOG/BQTR_SETTINGS
```
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.
Insira a transação SM30 e abra a tabela /GOOG/SERVIC_MAP.
Para o valor Nome de chave do Google Cloud que você anotou em uma etapa anterior, anote os nomes de destino do RFC.
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/.
Execute a replicação novamente.

`/GOOG/BQTR: 404 - Table PROJECT_ID:DATASET_NAME.TABLE_NAME not found`

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

Causa:nos destinos RFC que o SDK do ABAP para Google Cloud 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:

Na GUI do SAP, insira o código da transação /GOOG/BQTR_SETTINGS.
Insira a chave de transferência em massa que gerou o erro.
Clique no ícone Executar. Anote o valor na coluna Nome da chave do Google Cloud.
Insira a transação SM30 e abra a tabela /GOOG/CLIENT_KEY no modo de exibição.
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.
Insira o código da transação SM59.
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.
No console do Google Cloud, acesse a página Cloud DNS de serviços de rede.

Acessar Cloud DNS
Clique na zona particular que contém os registros DNS dos endpoints do Private Service Connect, criados para permitir que o BigQuery Toolkit para SAP se conecte de forma particular às APIs do BigQuery e do IAM.
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.
Execute a replicação novamente.

`/GOOG/BQTR: 404 - Not Found Requested entity was not found`

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

Causa:para a carga de trabalho em execução em 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:

Na GUI do SAP, insira a transação /GOOG/BQTR_SETTINGS precedida por /n:
```
/n/GOOG/BQTR_SETTINGS
```
Insira a chave de transferência em massa que gerou o erro.
Clique no ícone Executar. Anote o valor na coluna Nome da chave do Google Cloud.
Insira a transação SM30 e abra a tabela /GOOG/CLIENT_KEY.
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 Toolkit para SAP.
Execute a replicação novamente.

`/GOOG/BQTR: 413 - Request Entity Too Large`

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

Causa:esse problema pode ser causado quando o tamanho de bytes do bloco enviado pelo BigQuery Toolkit 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 Toolkit para SAP para a tabela. É possível ajustar o tamanho do bloco executando a transação /GOOG/BQTR_SETTINGS ou ativar o tamanho dinâmico do bloco para ajustar automaticamente o tamanho do bloco. Confira mais informações:

`/GOOG/BQTR: 404 - Not found: Dataset DATASET_NAME`

Problema:ao tentar validar a segurança Google Cloud ou carregar dados em uma tabela do BigQuery, você recebe a mensagem /GOOG/BQTR: 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 módulo de transferência de dados do BigQuery 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.

`/GOOG/BQTR : Unable to interpret VALUE as a BOOLEAN`

Problema: o carregamento ou a replicação de um registro falha com a mensagem /GOOG/BQTR : 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/BQTR_SETTINGS para alterar o tipo de dados para o qual o campo de origem está mapeado ou remover o mapeamento do tipo de dados e aceitar o tipo de dados padrão.

`/GOOG/BQTR: 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/BQTR: 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/BQTR_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.

`/GOOG/BQTR: 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/BQTR: 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/BQTR_SETTINGS. Quando a flag BREAK não está definida, o BigQuery Toolkit 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:

Para problemas de Quota Exceeded, Request Entity Too Large ou HTTP Communication Failure, siga as etapas de solução de problemas para /GOOG/BQTR: 413 - Entidade de solicitação muito grande.
Interrompa o carregamento atual, exclua a tabela de destino do BigQuery e reinicie um novo carregamento.
Para interromper o envio de dados ao BigQuery e encerrar o job de replicação quando um bloco com erro for encontrado, defina a sinalização BREAK, que é recomendada em ambientes de produção.

Para informações sobre como configurar a flag BREAK, consulte Especificar a criação de tabelas e outros atributos gerais.

Receba suporte da comunidade

Faça suas perguntas e discuta o BigQuery Toolkit para SAP com a comunidade nos Fóruns do Cloud.

Receber suporte

Google Cloud oferece suporte para problemas e dúvidas relacionados à instalação, configuração, operação e manutenção do BigQuery Toolkit para SAP. No entanto, o suporte é limitado ao próprio kit de ferramentas.

Google Cloud não oferece suporte a outros componentes do ambiente, como infraestrutura de rede, bancos de dados, sistemas operacionais ou softwares de terceiros. Para problemas relacionados a componentes de ambiente que não sejam o BigQuery Toolkit para SAP, entre em contato com o fornecedor ou provedor de suporte apropriado.

Para funcionalidades fornecidas pela SAP, como o provisionamento de dados operacionais (ODP, na sigla em inglês) e a transformação de paisagem do SAP (SLT, na sigla em inglês), entre em contato com o suporte da SAP para receber ajuda.

Se você precisar de ajuda para resolver problemas com o BigQuery Toolkit 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.