Resolver problemas com as exportações do BigQuery

Nesta página, apresentamos problemas comuns que você pode encontrar ao usar o Partner Sales Console para exportar dados de refaturamento para o BigQuery e como resolver esses problemas.

Não há valores para os custos faturáveis

As linhas que representam tributos, ajustes e arredondamentos são específicas do processo de reconciliação de faturas e não contêm valores de custos faturáveis para clientes ou parceiros de canal.

Cobranças sem custos de lista

Algumas cobranças (por exemplo, cobranças de suporte) não têm um custo de lista associado. As configurações de mudanças no preço dessas cobranças que usam a regra Custo de lista vão usar o custo base para calcular o novo preço.

Quando você cria uma exportação do BigQuery usando o Partner Sales Console, o item de linha para esses tipos de cobranças mostra null na coluna cost_at_list. Isso pode causar uma discrepância ao visualizar a cobrança na exportação e no console do Google Cloud.

Para resolver esse problema, use SUM(IFNULL(cost_at_list, cost)) em vez de SUM(cost_at_list) ao consultar uma exportação de refaturamento.

Tributos nos dados exportados

Os tributos de cada subconta de faturamento associada à sua conta de faturamento principal são calculados com base no local informado nos detalhes da conta. A localização dos seus clientes não afetará os tributos cobrados nas contas deles.

Se uma subconta de faturamento tiver o cost_type definido como 'tax', os dados exportados vão mostrar a atribuição da sua taxa fiscal local conforme se aplica à conta. Esse valor é baseado na parte de uso do cliente e nos custos adicionais incorridos.

Valores nulos para custos

Todas as linhas das exportações que tiverem um cost_type de 'tax' mostrarão null nos campos customer_cost e channel_partner_cost. Antes de gerar uma fatura para esse tipo de cliente, revise essas linhas e verifique se os valores corretos estão em vigor.

Subcontas não atribuídas e não associadas

Criar um direito do Google Cloud e vinculá-lo a um cliente cria uma subconta de faturamento para esse cliente. Se você não criar esse direito, talvez apareçam subcontas de faturamento não atribuídas na sua conta de faturamento principal.

Usar o Partner Sales Console para remover um cliente que tem subcontas de faturamento atribuídas fará com que essas subcontas sejam desassociadas.

Valores nulos para subcontas

O uso do BigQuery para exportar dados que incluem subcontas não atribuídas ou não associadas fará com que as colunas a seguir mostrem um valor de null para essas subcontas.

  • entitlement_name
  • customer_name
  • customer_cost
  • credits.customer_amount
  • channel_partner_name
  • channel_partner_cost
  • credits.channel_partner_amount

Para resolver esse problema, atribua essas subcontas de faturamento aos clientes.

Restaurando a tabela de exportação para um estado anterior

Se você acidentalmente derrubou a tabela de exportação ou excluiu alguns dos dados dela, ou se quer reverter a tabela para um estado anterior, é possível recuperá-la usando o recurso de viagem no tempo do BigQuery. Por exemplo, você pode executar o seguinte comando para restaurar a tabela para um estado anterior:

bq cp PROJECT_ID:DATASET_ID.reseller_billing_detailed_export_v1@REVERT_TO PROJECT_ID:DATASET_ID.reseller_billing_detailed_export_v1

REVERT_TO representa o tempo, em segundos da época Unix, para o qual você quer reverter. Só é possível voltar até sete dias, e os dados não são preenchidos.

A exportação não está adicionando novos dados

Se nenhuma linha nova estiver aparecendo na exportação, há vários problemas que podem impedir que ela funcione:

Você ativou as exportações recentemente

Depois que as exportações forem ativadas, pode levar até um dia para que o uso apareça nas tabelas. Se nada for exibido por mais tempo do que isso, considere os outros possíveis problemas aqui.

O conjunto de dados não pode ser acessado pela conta de serviço

O conjunto de dados não poderá ser atualizado se nossa conta de serviço não tiver acesso a ele. Para atualizá-lo automaticamente, clique em "Atualizar" na página Exportação de faturamento no Partner Sales Console.

O faturamento não está ativado para o projeto

A exportação poderá parar de funcionar se o faturamento não estiver ativado no projeto. Siga estas instruções para ativar o faturamento. Se você estiver usando o BigQuery Sandbox, será necessário fazer upgrade da sua conta.

Acesso no nível da linha ou da coluna está ativado no conjunto de dados

Se o conjunto de dados tiver controle de acesso no nível da linha ou da coluna, a exportação falhará. Para reativar, exclua a política de acesso no nível da linha e de acesso no nível da coluna.

Você não tem contas de faturamento principais

A exportação não vai funcionar se não houver contas de faturamento principais para exportar. Verifique se há contas de faturamento ativas para a fonte de dados selecionada.

A exportação tem um esquema inválido

Não é possível modificar o esquema da tabela de exportação. Para adicionar ou remover colunas, crie uma visualização ou uma visualização materializada. Também é possível mesclar suas outras tabelas nas consultas. Se a tabela ficar nesse estado, será necessário revertê-la para ter todas as colunas corretas e nada mais.

Reativando a exportação

Depois de encontrar e corrigir o problema, acesse a página Exportação de faturamento no Partner Sales Console. Observe o erro na página informando que a exportação está desativada.

Para reativar a exportação, clique em Atualizar.