Gerenciar o BigQuery Toolkit para operações SAP

Este documento mostra aos administradores da SAP, aos desenvolvedores da SAP ou a outras pessoas como realizar tarefas operacionais do BigQuery Toolkit para SAP.

Tamanho do bloco dinâmico

Se você encontrar erros porque o tamanho de bytes dos blocos excede o tamanho máximo de bytes para solicitações HTTP aceitas pelo BigQuery, será necessário reduzir o tamanho de bytes manualmente reduzindo o tamanho do bloco. O recurso de tamanho de bloco dinâmico permite reduzir automaticamente o tamanho do bloco e repetir a replicação para o BigQuery quando o tamanho de byte de um bloco excede o tamanho máximo de byte para solicitações HTTP aceitas pelo BigQuery. O tamanho de bloco dinâmico ajuda a evitar a maioria das falhas de replicação por exceder o tamanho de bytes de uma solicitação. Você receberá um erro somente se o tamanho do bloco atingir 1, mas o tamanho do byte permanecer mais do que o limite do BigQuery no número de bytes em cada solicitação HTTP.

Ative o tamanho de bloco dinâmico na configuração de transferência de dados de uma tabela usando a transação /GOOG/BQTR_SETTINGS. O tamanho do bloco dinâmico é uma configuração opcional. Para saber como ativar o tamanho de bloco dinâmico, consulte Especificar a criação de tabelas e outros atributos gerais.

Quando o BigQuery Toolkit para SAP reduz o tamanho do bloco, a seguinte mensagem de informação é retornada ao aplicativo ABAP de chamada no parâmetro et_return:

Dynamic chunking triggered. Chunk size reduced from INITIAL_CHUNK_SIZE_VALUE to FINAL_REDUCED_CHUNK_SIZE_VALUE

Transporte as configurações de transferência em massa para a produção

Para transportar as configurações de transferência em massa do BigQuery Toolkit para SAP para a produção, exporte as configurações de um sistema de desenvolvimento e importe-as para o sistema de produção.

Opcionalmente, é possível importar duas partes separadas das configurações de uma transferência em massa para produção:

  • As configurações da chave de cliente da tabela /GOOG/CLIENT_KEY, que podem ser acessadas usando a transação SM30.
  • O BigQuery Toolkit para configurações de transferência em massa do SAP, que pode ser acessado usando a transação /GOOG/BQTR_SETTINGS.

Exportar configurações de transferência em massa de um sistema de desenvolvimento

No sistema de desenvolvimento do SAP, exporte cada parte das configurações de transferência em massa:

  1. Exporte as configurações de transferência em massa do BigQuery Toolkit para SAP:

    1. Na GUI do SAP, execute o código de transação /GOOG/SDK_IMG.

      Como alternativa, execute o código da transação SPRO e clique em IMG de referência do SAP.

    2. Clique em ABAP SDK for Google Cloud > Configurações básicas > Transferência de dados do BigQuery: manutenção de configurações.

    3. No campo Tabela de configurações, selecione Transferência em massa.

    4. Selecione os registros de transferência em massa que você está transportando para a produção.

    5. Clique em Transferência em massa de transporte.

    6. Em Solicitar solicitação do Workbench, insira o número da solicitação de transporte e clique no ícone Continuar. Para cada registro de transferência em massa selecionado, as configurações das seguintes tabelas de configuração personalizadas estão incluídas no transporte:

      • /GOOG/BQTR_MASTR
      • /GOOG/BQTR_TABLE
      • /GOOG/BQTR_FIELD

    As configurações da transferência em massa são salvas em uma solicitação de transporte.

  2. Exporte as configurações da chave do cliente incluindo manualmente o conteúdo da tabela /GOOG/CLIENT_KEY na solicitação de transporte.

  3. Salve os arquivos na estação de trabalho local.

Importar configurações de transferência em massa para um sistema de produção

Importe a solicitação de transporte que contém as configurações da transferência em massa.

No sistema de produção do SAP, importe cada parte das configurações de transferência em massa:

  1. Na GUI do SAP, importe a solicitação de transporte que contém as configurações de transferência em massa.

  2. Na GUI do SAP, execute o código de transação /GOOG/SDK_IMG.

    Como alternativa, execute o código da transação SPRO e clique em IMG de referência do SAP.

  3. Clique em ABAP SDK for Google Cloud > Configurações básicas > Configurar chave do cliente.

  4. Atualize as configurações da chave do cliente conforme necessário para o ambiente de produção.

  5. Clique em ABAP SDK for Google Cloud > Configurações básicas > Transferência de dados do BigQuery: manutenção de configurações.

  6. Verifique se as transferências em massa corretas são exibidas na tela Transferências em massa.

  7. Nas telas de configurações Tabelas e Campos subsequentes, atualize outros valores para o mapeamento de tabela e campo conforme necessário para o ambiente de produção.

  8. Para testar a configuração, execute o programa de carregamento de dados que chama o BigQuery Toolkit para SAP.

Conferir as configurações da transferência de dados do BigQuery

Para conferir as configurações de transferência em massa do módulo de transferência de dados do BigQuery, faça o seguinte:

  1. Na GUI do SAP, execute o código de transação /GOOG/SDK_IMG.

    Como alternativa, execute o código da transação SPRO e clique em IMG de referência do SAP.

  2. Clique em ABAP SDK for Google Cloud > Configurações básicas > Transferência de dados do BigQuery: exibição de configurações.

Como alternativa, é possível conferir as configurações usando a transação /GOOG/BQTR_SETTINGS.

Validação de replicação

Quando você especifica a opção Sinalização de campos extras na configuração de transferência em massa, o BigQuery Toolkit para SAP adiciona colunas extras ao esquema da tabela no BigQuery. Essas colunas capturam os seguintes detalhes:

  • Informações sobre o tipo de mudança que acionou a replicação para cada registro.
  • Um carimbo de data/hora que indica quando o BigQuery Toolkit para SAP recebeu a parte que contém esse registro.

Usando as informações nessas colunas, é possível validar o processo de replicação, garantindo a integridade e a consistência dos dados entre o sistema SAP e o BigQuery. É possível usar os tipos de alteração e o carimbo de data/hora para consultar os seguintes tipos de contagem de registro:

  • O número de registros que são carregados em uma tabela do BigQuery durante um carregamento inicial.
  • O número de registros replicados em um dia especificado em uma tabela do BigQuery.
  • O número total de registros exclusivos em uma tabela do BigQuery.

Para receber essas contagens, é possível consultar a tabela do BigQuery diretamente enviando consultas SQL no console do Google Cloud.

Para uma visão geral da Sinalização de campos extras, consulte Campos extras para alterações de registro e consultas de contagem.

Consultas SQL de contagens de registro

É possível executar consultas SQL para verificar as contagens de registros nas tabelas do BigQuery usando a página Editor do SQL do BigQuery no console do Google Cloud.

Consulte a contagem de registros inseridos no modo de carregamento inicial

Quando um esquema de tabela do BigQuery inclui a coluna operation_flag opcional, os registros inseridos na tabela no modo de carregamento inicial incluem a sinalização de operação L.

Para ver a contagem de registros recebidos pelo BigQuery durante um carregamento inicial, execute a seguinte consulta:

SELECT COUNT(*)
  FROM
      `PROJECT.DATASET.TABLE`
  WHERE operation_flag = 'L'

Consulte o número de registros inseridos no modo de replicação

Quando um esquema de tabela do BigQuery inclui a coluna operation_flag opcional, os registros inseridos na tabela no modo de replicação incluem uma das sinalizações de operação a seguir:

  • I: o registro foi inserido na tabela de origem.
  • D: o registro foi excluído da tabela de origem.
  • U: o registro foi atualizado na tabela de origem.

Para saber o número de registros recebidos pelo BigQuery no modo de replicação, execute a seguinte consulta:

SELECT COUNT(*)
  FROM
      `PROJECT.DATASET.TABLE`
  WHERE operation_flag = 'I' | 'D' | 'U'

Consulte a contagem total de registros em uma tabela do BigQuery

Quando um esquema de tabela do BigQuery inclui a coluna recordstamp opcional, o campo recordstamp correspondente de cada registro inserido na tabela contém um carimbo de data/hora que indica quando o registro foi enviado pelo BigQuery Toolkit para SAP para o BigQuery.

Para ver uma contagem total dos registros em uma tabela do BigQuery que pode ser comparada com a contagem total dos registros em uma tabela de origem, use os campos recordstamp e is_deleted para contar os dados: registros exclusivos na tabela do BigQuery que não foram excluídos da tabela de origem.

Se a tabela de origem estiver sendo atualizada ou a replicação estiver ativa quando você consultar os registros, a contagem de registros nas tabelas de origem e de destino talvez não corresponda exatamente.

Para receber a contagem atual de registros exclusivos na tabela de destino do BigQuery, execute a seguinte consulta:

SELECT COUNT(*)
  FROM (
    SELECT
      *,
      ROW_NUMBER() OVER (PARTITION BY KEY_FIELD_1, ..., KEY_FIELD_N ORDER BY recordstamp DESC) row_num
    FROM
      `PROJECT.DATASET.TABLE` )
  WHERE row_num = 1 AND is_deleted = false

Editar o mapa de campos do BigQuery em um arquivo CSV

As seções a seguir descrevem como exportar o mapeamento de campo padrão para que os engenheiros de dados ou administradores do BigQuery possam editar os valores do campo de destino sem precisar de acesso ao sistema SAP.

Ao editar os valores do campo de destino, siga estas regras:

  • Não modifique os valores nas colunas SAP Data Source Name e SAP Field Name.
  • Na coluna Enviar flag não compactada, para ativar a compactação de registros, marque o campo com apenas um X. Caso contrário, deixe o campo em branco.

Criar uma planilha ou um arquivo de texto para os mapeamentos de campo padrão

Para criar um arquivo CSV para edição fora do servidor SAP, faça o seguinte:

  1. Na GUI do SAP, execute o código de transação /GOOG/SDK_IMG.

    Como alternativa, execute o código da transação SPRO e clique em IMG de referência do SAP.

  2. Clique em ABAP SDK for Google Cloud > Configurações básicas > Transferência de dados do BigQuery: manutenção de configurações.

  3. Na tela Manutenção de configurações de transferência de dados do BigQuery, especifique os seguintes valores:

    • No campo Tabela de configurações, especifique Campos.
    • No campo Chave de transferência em massa, especifique o ID da transferência em massa que você está atualizando.
    • No campo Nome da tabela, deixe em branco para trabalhar com todos os campos de todas as tabelas ou especifique um nome de tabela para trabalhar com uma tabela específica.
    • Não preencha os outros campos.
  4. Clique no ícone Executar. A tela Manutenção de configurações de transferência de dados do BigQuery: campos é exibida.

  5. Na tela Manutenção de configurações de transferência de dados do BigQuery: campos, oculte todas as colunas, exceto as que estão na lista a seguir, clicando com o botão direito do mouse nos cabeçalhos das colunas e selecionando Ocultar no menu suspenso:

    • Nome da fonte de dados do SAP
    • Nome do campo SAP
    • Elemento de dados externos
    • Nome do campo externo
    • Descrição do campo
    • Enviar flag descompactada
  6. Com as seis colunas restantes exibidas, clique no ícone Exportar.

  7. No menu Exportar, selecione uma das seguintes opções:

    • Planilha
    • Arquivo local. Para facilitar a conversão do conteúdo do arquivo no formato CSV, recomendamos que você salve o arquivo no formato Texto com guias.
  8. Clique no ícone de verificação para salvar os mapeamentos de campo padrão.

Converter a planilha ou o arquivo de texto no formato CSV

Para fazer upload dos mapeamentos de campo editados usando a transação personalizada /GOOG/BQTR_SETTINGS, os mapeamentos de campo precisam estar no formato CSV.

Se você estiver usando uma planilha, salve a planilha como um arquivo CSV antes de fazer upload.

Se você estiver usando um arquivo local em um formato separado por tabulação ou qualquer outro formato, será necessário modificar o arquivo para ficar em formato CSV.

Exemplo:

SAP Table,SAP Field Name,External Data Element,External Field Name,Field Description, Send Uncompressed Flag
SAP_TABLE_NAME,SAP_FIELD_NAME1,BIGQUERY_DATA_TYPE,BIGQUERY_FIELD_NAME1,BIGQUERY_FIELD_DESCRIPTION1, SEND_UNCOMPRESSED_FLAG1
SAP_TABLE_NAME,SAP_FIELD_NAME2,BIGQUERY_DATA_TYPE,BIGQUERY_FIELD_NAME2,BIGQUERY_FIELD_DESCRIPTION2, SEND_UNCOMPRESSED_FLAG2
SAP_TABLE_NAME,SAP_FIELD_NAME3,BIGQUERY_DATA_TYPE,BIGQUERY_FIELD_NAME3,BIGQUERY_FIELD_DESCRIPTION3, SEND_UNCOMPRESSED_FLAG3

Fazer o upload do arquivo CSV

Para fazer upload de um arquivo CSV editado, siga estas etapas:

  1. Na GUI do SAP, execute o código de transação /GOOG/SDK_IMG.

    Como alternativa, execute o código da transação SPRO e clique em IMG de referência do SAP.

  2. Clique em ABAP SDK for Google Cloud > Configurações básicas > Transferência de dados do BigQuery: manutenção de configurações.

  3. Na tela Transferência de dados do BigQuery: manutenção de configurações, especifique os seguintes valores:

    • No campo Tabela de configurações, especifique Campos.
    • No campo Chave de transferência em massa, especifique o ID da transferência em massa que você está atualizando.
    • Marque a caixa de seleção Fazer upload do arquivo.
  4. Clique no ícone Executar. A caixa de diálogo Selecionar arquivo para fazer upload será aberta.

  5. Na caixa de diálogo Selecionar arquivo para fazer upload, selecione o arquivo CSV que contém os valores do campo editado.

  6. Clique em Abrir.

  7. Se você receber um aviso de segurança, clique em Permitir. O arquivo é carregado, e os valores modificados no arquivo aparecem nas linhas aplicáveis na tela Manutenção de configurações do BigQuery: campos.

  8. Clique no ícone Salvar.

  9. Para confirmar que os valores foram aplicados, compare os valores no arquivo CSV com os exibidos no sistema SAP.

Como corrigir erros nos dados de origem

Quando a API de streaming do BigQuery recebe um bloco de registros do BigQuery Toolkit para SAP, ela verifica se há erros de dados antes de inserir qualquer registro na tabela do BigQuery.

É possível controlar como a API BigQuery e o BigQuery Toolkit para SAP respondem quando erros de dados são encontrados. Para isso, especifique as seguintes flags nas configurações de transferência em massa:

  • A sinalização Skip Invalid Records (SKIP)
  • A sinalização Break at First Error Flag (BREAK)

A sinalização SKIP

Se você especificar a sinalização SKIP, quando a API do BigQuery receber um bloco de registros e encontrar um registro com um erro de dados, a API do BigQuery descartará ou pulará, o registro com o erro e continua inserindo todos os outros registros do bloco na tabela do BigQuery.

Se você não especificar a flag SKIP, quando o BigQuery encontrar um registro com um erro de dados, ele descartará todo o bloco sem inserir nenhum registro dele na tabela do BigQuery. Esse comportamento é o padrão.

Especificar a flag SKIP é melhor para ambientes de desenvolvimento e controle de qualidade e não é recomendado para ambientes de produção.

É possível especificar a flag SKIP na transação /GOOG/BQTR_SETTINGS ao configurar a replicação. A especificação é armazenada na tabela de configuração /GOOG/BQTR_MASTR.

Para ver como as especificações de SKIP interagem com as de BREAK, consulte a Tabela de matrizes para interações de SKIP e BREAK.

A sinalização BREAK

Se você especificar a flag BREAK, quando o BigQuery Toolkit for SAP for notificado pela API BigQuery de que um erro de dados foi encontrado em um registro, o BigQuery Toolkit for SAP vai parar de enviar registros para o BigQuery e encerrar o job de replicação. Esse comportamento é o padrão.

Se você não especificar a flag BREAK, quando o BigQuery Toolkit for SAP for notificado pelo BigQuery de que um erro de dados foi encontrado em um registro, o BigQuery Toolkit para SAP continuará enviando registros para o BigQuery enviando o próximo bloco, e o job de replicação continuará.

Especifique a sinalização BREAK em ambientes de produção.

É possível especificar a flag BREAK na transação /GOOG/BQTR_SETTINGS ao configurar a replicação. Quando você cria uma nova chave de transferência em massa, a flag BREAK é ativada por padrão.

A especificação é armazenada na tabela de configuração /GOOG/BQTR_MASTR.

Para ver como as especificações de BREAK interagem com as de SKIP, consulte a Tabela de matrizes para interações de SKIP e BREAK.

Tabela de matrizes para interações de SKIP e BREAK

É possível configurar o módulo de transferência de dados do BigQuery para processar erros de dados das seguintes maneiras:

Sinalização SKIP Sinalização BREAK Comportamento
FALSO TRUE

O BigQuery descarta a parte atual dos registros sem inserir nenhum registro da parte atual na tabela do BigQuery.

O BigQuery Toolkit para SAP não envia mais blocos de registros da parte atual e encerra o job de replicação.

Esta é a configuração padrão e recomendada.

FALSE FALSO

O BigQuery descarta a parte atual dos registros sem inserir nenhum registro da parte atual na tabela do BigQuery.

O BigQuery Toolkit para SAP envia os blocos restantes de registros da parte atual e recupera a próxima parte. O BigQuery Toolkit para SAP não encerra o job de replicação.

VERDADEIRO TRUE

O BigQuery descarta somente o registro que contém o erro e insere o restante dos registros no bloco atual na tabela do BigQuery.

O BigQuery Toolkit para SAP não envia mais blocos de registros da parte atual e encerra o job de replicação.

VERDADEIRO FALSO

O BigQuery descarta somente o registro que contém o erro e insere o restante dos registros no bloco atual na tabela do BigQuery.

O BigQuery Toolkit para SAP envia os blocos restantes de registros da parte atual e recupera a próxima parte. O BigQuery Toolkit para SAP não encerra o job de replicação.

Mudanças na estrutura do objeto do dicionário SAP

Esta seção explica como lidar com mudanças na definição dos objetos de dicionário no SAP.

Adicionar uma coluna ao objeto de dicionário

Se você estiver adicionando uma coluna a um objeto de dicionário, faça o seguinte:

  1. Pare o aplicativo de replicação de dados personalizado que usa a classe de carga de dados /GOOG/CL_BQTR_DATA_LOAD.
  2. Adicione uma nova coluna ao objeto de dicionário no SAP.
  3. Opcionalmente, atualize o mapeamento no nível do campo na transação /GOOG/BQTR_SETTINGS.
  4. Reinicie o aplicativo de replicação de dados personalizado.
  5. Valide o resultado da replicação no BigQuery.

Excluir uma coluna do objeto de dicionário

Para excluir uma coluna de um objeto de dicionário, faça o seguinte:

  1. Pare o aplicativo de replicação de dados personalizado que usa a classe de carga de dados /GOOG/CL_BQTR_DATA_LOAD.
  2. Exclua uma coluna do objeto de dicionário.
  3. No BigQuery, exclua a coluna da tabela de destino do BigQuery. Para mais informações sobre as etapas para excluir uma coluna de uma tabela, consulte a documentação do BigQuery.
  4. Opcionalmente, atualize o mapeamento no nível do campo na transação /GOOG/BQTR_SETTINGS.
  5. Reinicie o aplicativo de replicação de dados personalizado.
  6. Valide o resultado da replicação no BigQuery.

Alterar o tipo de dados de uma coluna existente

Ao mudar o tipo de dados de uma coluna existente no objeto de dicionário do SAP, é necessário seguir etapas específicas, dependendo se você está mudando o tipo de dados para um tipo compatível ou não com a tabela de destino do BigQuery.

Um tipo de dados é compatível com o tipo de dados na tabela de destino do BigQuery quando o tipo de dados atual e o novo tipo de dados de uma coluna existente mapeiam para o mesmo tipo de dados na tabela de destino do BigQuery. Por exemplo, se o tipo de dados de uma coluna for alterado de INT1 para INT2 em uma tabela de origem, os dois tipos de dados serão compatíveis com o tipo INTEGER na tabela de destino do BigQuery.

Para mais informações sobre o mapeamento de tipos de dados no módulo de transferência de dados do BigQuery, consulte Mapeamento de tipos de dados.

Mudar o tipo de dados para um tipo de dados compatível

Para mudar o tipo de dados de uma coluna para um tipo compatível, faça o seguinte:

  1. Se preferir, interrompa o aplicativo de replicação de dados personalizado que usa a classe de carregamento de dados /GOOG/CL_BQTR_DATA_LOAD.
  2. Mude o tipo de dados para um tipo compatível no sistema de origem.
  3. Opcionalmente, atualize o mapeamento no nível do campo na transação /GOOG/BQTR_SETTINGS.
  4. Se você tiver interrompido o aplicativo de replicação de dados personalizado, reinicie-o.
  5. Valide o resultado da replicação no BigQuery.

Mudar o tipo de dados para um tipo não compatível

Para mudar o tipo de dados de uma coluna para um tipo não compatível, faça o seguinte:

  1. Pare o aplicativo de replicação de dados personalizado que usa a classe de carga de dados /GOOG/CL_BQTR_DATA_LOAD.
  2. No BigQuery, exclua a tabela de destino.
  3. Mudar o tipo de dados no sistema de origem.
  4. Opcionalmente, atualize o mapeamento no nível do campo na transação /GOOG/BQTR_SETTINGS.
  5. Inicie o aplicativo de replicação de dados personalizado. Conforme necessário, talvez seja necessário iniciar um carregamento inicial dos dados atuais.

Saídas de aprimoramento

O BigQuery Toolkit para SAP oferece vários pontos de melhoria no código, em que um desenvolvedor do ABAP pode inserir código para adicionar recursos personalizados.

Classes

A tabela a seguir lista as funções compatíveis com os pontos de aprimoramento, os métodos e a classe que contém o ponto de aprimoramento.

Função Classe Método Spot Opção
Atualize o mapeamento de um campo, como o nome do campo externo e o tipo de dados. /GOOG/CL_BQTR_DATA_LOAD_BASE CREATE_FLD_MAPPINGS /GOOG/ES_BQTR_DATA_LOAD_BASE /GOOG/UPDATE_FIELD_MAPPING
Atualize ou mapeie campos de tabela para adicionar ou remover campos. /GOOG/CL_BQTR_DATA_LOAD_BASE CREATE_FLD_MAPPINGS /GOOG/ES_BQTR_DATA_LOAD_BASE /GOOG/UPDATE_FIELD_MAPPINGS
Altere o valor de um campo de origem antes de ele ser convertido em um campo de destino. /GOOG/CL_BQTR_DATA_LOAD FILL_TARGET_RECORDS /GOOG/ES_BQTR_DATA_LOAD /GOOG/CHANGE_SOURCE_FIELD
Depois que um campo de origem for convertido em um campo de destino na tabela de destino, altere o valor do campo de destino. /GOOG/CL_BQTR_DATA_LOAD FILL_TARGET_RECORDS /GOOG/ES_BQTR_DATA_LOAD /GOOG/FILL_TARGET_FIELD
Adicione um campo à tabela de destino que não existe nela durante a conversão da tabela de origem para destino. /GOOG/CL_BQTR_DATA_LOAD FILL_TARGET_RECORDS /GOOG/ES_BQTR_DATA_LOAD /GOOG/FILL_EXTRA_FIELD
Prepare um campo de esquema do BigQuery antes de criar a tabela do BigQuery. /GOOG/CL_BQTR_CLIENT_BQ_BASE PREP_BQ_TABLE_SCHEMA /GOOG/ES_BQTR_CLIENT_BQ /GOOG/PREPARE_SCHEMA_FIELD
No caso de erros HTTP originados no lado do servidor do BigQuery, para resolver o problema, você pode coletar dados de registro após as chamadas HTTP para a API BigQuery. /GOOG/CL_BQTR_CLIENT_BQ_REPL INSERT_TABLEDATA /GOOG/ES_BQTR_CLIENT_BQ_REPL /GOOG/LOG_INSERT_ERROR

Relatórios

A tabela a seguir lista as funções compatíveis com os pontos de aprimoramento, os métodos e os relatórios que contêm o ponto de aprimoramento.

Função Relatório Método Spot Opção
Para adicionar verificações de autoridade ao programa de configurações de transferência de dados do BigQuery. /GOOG/R_BQTR_SETTINGS AUTHORITY_CHECK /GOOG/ES_BQTR_SETTINGS /GOOG/AUTHORITY_CHECK

Configurações avançadas

Também é possível modificar as configurações avançadas do BigQuery Toolkit para SAP. Recomendamos que você modifique os parâmetros das configurações avançadas somente após uma análise abrangente e um impacto dos novos valores no desempenho. Você é responsável por garantir que as novas configurações avançadas do BigQuery Toolkit para SAP não causem falhas e problemas de desempenho.

As configurações avançadas do BigQuery Toolkit para SAP são aplicadas no nível do sistema e são comuns a todas as chaves de transferência em massa. Se os parâmetros das configurações avançadas não forem modificados, o BigQuery Toolkit para SAP vai funcionar com as configurações padrão.

Para modificar os parâmetros das configurações avançadas, faça o seguinte:

  1. Na GUI do SAP, execute o código de transação /GOOG/SDK_IMG.

    Como alternativa, execute o código da transação SPRO e clique em IMG de referência do SAP.

  2. Clique em ABAP SDK for Google Cloud > Configurações básicas > Transferência de dados do BigQuery: manutenção de configurações.

  3. No menu suspenso Tabela de configurações, selecione Parâmetros.

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

  5. Clique no ícone Inserir linha.

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

    1. No campo Nome do parâmetro, insira o nome dele. A descrição do parâmetro é preenchida automaticamente.
    2. No campo Valor do parâmetro, insira um valor.

      Para saber mais sobre os parâmetros de configurações avançadas, consulte Parâmetros de configurações avançadas.

  7. Clique em Salvar.

    As configurações avançadas 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.

Parâmetros de configurações avançadas

A tabela a seguir mostra os parâmetros de configurações avançadas do BigQuery Toolkit para SAP.

Nome do parâmetro Descrição Valor padrão Valor válido
CHUNK_SIZE_DEF Essa configuração é o tamanho de bloco padrão compatível com o BigQuery Toolkit para SAP.
Se o tamanho de um bloco não for mantido nas configurações, o tamanho padrão será usado.
10.000 O valor precisa estar dentro dos limites de cota do BigQuery.
PERC_REDUC_DEF A redução percentual do tamanho do bloco.
Se o tamanho dinâmico do bloco for ativado, ele será reduzido por essa porcentagem até que um tamanho ideal seja alcançado e os dados no bloco sejam transferidos para o BigQuery.
50 O valor precisa ser de 1 a 99.

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.

Para resolver problemas com o BigQuery Toolkit para SAP, consulte Solução de problemas do BigQuery Toolkit para SAP.

Se você precisar de ajuda para resolver problemas com o ABAP SDK for Google Cloud, faça o seguinte: