Resolver problemas com exportações do BigQuery

Esta página apresenta problemas comuns que podem ocorrer ao usar o Partner Sales Console para exportar dados de refatura para o BigQuery e como resolver esses problemas.

Nenhum valor para custos faturáveis

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

Cobranças sem custos de lista

Algumas cobranças (por exemplo, de suporte) não têm um custo de lista associado. As configurações de reprecificação para essas cobranças que usam a regra List Cost vão usar o custo base para calcular o custo reprecificado.

Quando você cria uma exportação do BigQuery usando o Partner Sales Console, o item de linha desses tipos de cobranças é mostrado como null na coluna cost_at_list. Isso pode levar a 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 impostos de cada subconta de faturamento associada à sua conta de faturamento principal são calculados com base no local listado nos detalhes da conta. A localização dos seus clientes não afeta 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 alíquota de imposto local conforme aplicável a essa conta. Esse valor é baseado na parte do uso do cliente e em quaisquer custos adicionais incorridos.

Valores nulos para custos

Todas as linhas nas exportações que tiverem um cost_type de 'tax' vão mostrar 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 nem 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, subcontas de faturamento não atribuídas vão aparecer na sua conta de faturamento principal.

Usar o Partner Sales Console para remover um cliente que tem subcontas de faturamento atribuídas vai fazer 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 faz 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.

Como restaurar a tabela de exportação para um estado anterior

Se você excluir acidentalmente a tabela de exportação ou alguns dos dados dela ou se quiser reverter a tabela para um estado anterior, é possível recuperá-la usando o recurso de viagem no tempo do BigQuery. Por exemplo, execute o comando abaixo para restaurar a tabela a 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 desde a época Unix, para o qual você quer reverter. Você só pode voltar até 7 dias, e seus dados não são preenchidos.

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

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

Você ativou as exportações recentemente

Depois que as exportações são ativadas, pode levar até um dia para que o uso apareça nas suas tabelas. Se nada aparecer nesse período, considere os outros possíveis problemas aqui.

A conta de serviço não consegue acessar o conjunto de dados

O conjunto de dados não pode ser atualizado se a conta de serviço não tiver acesso a ele. Para atualizar isso 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 pode parar de funcionar se o faturamento não estiver ativado para o projeto. Siga estas instruções para ativar o faturamento. Se você estiver usando o sandbox do BigQuery, será necessário fazer upgrade da sua conta.

O 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 no nível da coluna, a exportação vai falhar. Para reativar, exclua a política de acesso no nível da linha e a política de acesso no nível da coluna.

Você não tem contas de faturamento principais

A exportação não funciona 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. Se você quiser adicionar ou remover colunas, crie uma visualização ou uma visualização materializada ou faça uma mesclagem com outras tabelas nas consultas. Se a tabela estiver nesse estado, você precisará reverter para ter todas as colunas corretas e nada mais.

Como reativar 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.