Use o explorador de empregos administrativos
Enquanto administrador do BigQuery, pode usar o explorador de tarefas administrativas para ajudar a monitorizar a atividade das tarefas na sua organização. O Jobs Explorer também oferece uma variedade de filtros e opções de ordenação para resolver problemas
e identificar trabalhos problemáticos. O explorador de tarefas elimina a necessidade de ter um conhecimento profundo do INFORMATION_SCHEMA e permite-lhe ver rapidamente informações sobre tarefas, como proprietário, projeto, utilização de slots, duração e muito mais, sem ter de escrever consultas INFORMATION_SCHEMA.
Também pode selecionar trabalhos individuais para abrir a página de detalhes do trabalho, que fornece detalhes da consulta, como gráficos de execução, texto SQL e histórico de execução, para ajudar a diagnosticar e resolver problemas de consultas. Nesta página, pode comparar duas tarefas para realçar as diferenças significativas entre elas e resolver potenciais problemas de desempenho.
O BigQuery fornece detalhes e estatísticas das tarefas através das seguintes INFORMATION_SCHEMAvistas:
INFORMATION_SCHEMA.JOBS_BY_PROJECTINFORMATION_SCHEMA.JOBS_BY_ORGANIZATIONINFORMATION_SCHEMA.JOBS_BY_USER
Funções necessárias
Para receber as autorizações de que
precisa para usar o explorador de tarefas administrativas,
peça ao seu administrador para lhe conceder a função de
Visualizador de recursos do BigQuery (roles/bigquery.resourceViewer)
do IAM na sua organização ou projeto.
Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.
Esta função predefinida contém as autorizações necessárias para usar o explorador de tarefas administrativas. Para ver as autorizações exatas que são necessárias, expanda a secção Autorizações necessárias:
Autorizações necessárias
São necessárias as seguintes autorizações para usar o explorador de tarefas administrativas:
-
Para ver dados ao nível do projeto:
bigquery.jobs.listAllno projeto -
Para ver dados ao nível da organização:
bigquery.jobs.listAllna organização -
Para filtrar por reservas na sua organização:
bigquery.reservations.listna organização
Também pode conseguir estas autorizações com funções personalizadas ou outras funções predefinidas.
Filtre tarefas
Para filtrar tarefas para consultas contidas nas visualizações INFORMATION_SCHEMA.JOBS*, faça o seguinte:
Na Google Cloud consola, aceda à página BigQuery.
No menu de navegação, clique em Explorador de trabalhos.
Na lista Localização, selecione a localização para a qual quer ver os trabalhos.
Aplique Filtros opcionais, conforme necessário:
- Âmbito do trabalho. Como o projeto atual, a organização e os seus trabalhos.
- Estado. Por exemplo, concluído, erro, ativo e em fila.
- Prioridade do trabalho. Como trabalhos interativos ou em lote.
- ID da tarefa.
- Proprietário. ID do email do proprietário da tarefa (aplicável apenas quando o âmbito da tarefa é o projeto ou a organização).
- ID do projeto. (Aplicável apenas quando o âmbito da tarefa é a organização)
- ID da reserva. (Aplicável apenas quando o âmbito da tarefa é a organização)
- Hora disponível mais do que. Trabalhos que demoraram mais tempo do que o tempo do intervalo especificado.
- Duração superior a. Tarefas que demoraram mais do que a duração especificada.
- Bytes processados mais do que. Tarefas que processaram mais bytes do que os bytes processados especificados.
- Estatísticas de consultas. Tipos de estatísticas de consultas, como contenção de slots, capacidade de mistura de memória excedida e alteração da escala de entrada de dados.
- Hash da consulta. O hash da consulta contém os hashes da consulta. É um hash STRING hexadecimal que ignora comentários, valores de parâmetros, UDFs e literais. Este campo é apresentado para consultas GoogleSQL bem-sucedidas que não são resultados da cache.
- Etiquetas.
key:valuepares que podem ser atribuídos a uma tarefa. Pode filtrar através de uma chave, um valor ou umakey:valuecombinação. - Categoria de emprego. O tipo de consulta, como Padrão ou Consulta contínua.
Veja os detalhes da execução da consulta
Para ver os detalhes da execução de consultas de tarefas, faça o seguinte:
Aceda à página Explorador de tarefas.
Para ver tarefas, clique em Explorador de tarefas.
Filtre os empregos para ver um número limitado de empregos.
Clique numa tarefa para a qual quer ver os detalhes de execução da consulta.
No painel Resultados da consulta, clique no separador Gráfico de execução para ver os detalhes de execução da sua tarefa.

Para informações sobre como interpretar as estatísticas, consulte o artigo Interprete as estatísticas de desempenho das consultas.
Obtenha detalhes da tarefa do BigQuery
Para pedir feedback ou apoio técnico para esta funcionalidade, envie um email para bq-performance-troubleshooting+feedback@google.com.
No explorador de tarefas administrativas, pode ver a página de detalhes do BigQuery. A página de detalhes da tarefa do BigQuery combina vários detalhes da consulta numa página para ajudar no diagnóstico e na resolução de problemas de consultas. O separador Desempenho compila informações de consultas, incluindo o gráfico de execução, o texto SQL e o histórico de execução.
O separador Desempenho também suporta a comparação de consultas, o que lhe permite comparar o seu histórico de utilização da consulta, bem como analisar e resolver qualquer possível degradação do desempenho. Para mais informações sobre a comparação de tarefas, consulte o artigo Compare tarefas.
Antes de começar
Para obter as autorizações de que precisa para trabalhar com detalhes das tarefas do BigQuery e detalhes ao nível do sistema, peça ao seu administrador que lhe conceda as seguintes funções de IAM na sua organização ou projeto:
-
Ver detalhes da tarefa:
Visualizador de recursos do BigQuery (
roles/bigquery.resourceViewer) – o projeto onde as consultas foram executadas -
Ver detalhes ao nível do sistema:
Visualizador de recursos do BigQuery (
roles/bigquery.resourceViewer) – o projeto de administração
Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.
Estas funções predefinidas contêm as autorizações necessárias para trabalhar com detalhes das tarefas do BigQuery e detalhes ao nível do sistema. Para ver as autorizações exatas que são necessárias, expanda a secção Autorizações necessárias:
Autorizações necessárias
As seguintes autorizações são necessárias para trabalhar com detalhes das tarefas do BigQuery e detalhes ao nível do sistema:
-
Para ver dados ao nível do projeto:
bigquery.jobs.listAllno projeto -
Para ver dados ao nível da organização:
bigquery.jobs.listAllna organização -
Para filtrar por reservas na sua organização:
bigquery.reservations.listna organização
Também pode conseguir estas autorizações com funções personalizadas ou outras funções predefinidas.
Ver detalhes do trabalho
Para ver a página de detalhes da tarefa, faça o seguinte:
Aceda à página Explorador de tarefas.
Opcional: filtre os empregos para restringir os empregos disponíveis apresentados.
Clique no ID da tarefa que quer ver. Para consultas que não criam uma tarefa, o ID da consulta é apresentado e o link está desativado. Para todas as outras consultas, se clicar no ID da tarefa, é apresentada a página Detalhes da tarefa.
O separador Desempenho é apresentado por predefinição. Pode navegar para os outros separadores para ver informações adicionais sobre o trabalho.
Informações de consulta disponíveis
A lista seguinte descreve as informações e as métricas disponíveis no separador Desempenho.
Consulta SQL: o texto da consulta SQL que criou a tarefa.
Detalhes da tarefa: as informações sobre a tarefa, incluindo o ID da tarefa, a hora de criação, os bytes processados e muito mais. Para mais informações, consulte o artigo Veja detalhes da tarefa.
Variação do desempenho: informações sobre o desempenho da tarefa em comparação com uma execução anterior da mesma consulta. O BigQuery compara a tarefa atual com uma execução anterior com bytes processados semelhantes (+/- 5%) e a duração da tarefa mais curta, se existir. Se não existir nenhuma execução anterior, o BigQuery compara a tarefa atual com a média das execuções anteriores nos últimos 30 dias. Se não existirem execuções anteriores, esta secção indica que não foi encontrado nenhum trabalho semelhante para comparação.
Histórico de execuções: uma lista de outras execuções desta consulta por hash de consulta. Neste painel, pode selecionar uma tarefa para comparar com a tarefa que está a ver. Para mais informações sobre a comparação de trabalhos, consulte o artigo Compare trabalhos.
Carga do sistema durante a execução: uma descrição dos recursos que o BigQuery usou para executar a tarefa. Isto inclui informações sobre as definições de reserva usadas por esta tarefa, se aplicável.
Gráfico de execução: o gráfico de execução desta tarefa. Para mais informações, consulte o artigo Obtenha estatísticas de desempenho das consultas.
Compare empregos
Para pedir feedback ou apoio técnico para esta funcionalidade, envie um email para bq-performance-troubleshooting+feedback@google.com.
A comparação do desempenho das tarefas permite comparar a tarefa de base com as tarefas segmentadas, e a análise de consultas realça os detalhes das tarefas que diferem significativamente entre as duas tarefas. Isto ajuda a resolver potenciais problemas de desempenho entre duas tarefas de consulta.
Os detalhes importantes a ter em consideração para otimizar as suas consultas quando compara duas consultas incluem a duração da tarefa, o tempo de intervalo e os bytes processados.
Antes de começar
Para obter as autorizações de que precisa para trabalhar com detalhes das tarefas do BigQuery e detalhes ao nível do sistema, peça ao seu administrador que lhe conceda as seguintes funções de IAM na sua organização ou projeto:
-
Ver detalhes da tarefa:
Visualizador de recursos do BigQuery (
roles/bigquery.resourceViewer) – o projeto onde as consultas foram executadas -
Ver detalhes ao nível do sistema:
Visualizador de recursos do BigQuery (
roles/bigquery.resourceViewer) – o projeto de administração
Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.
Estas funções predefinidas contêm as autorizações necessárias para trabalhar com detalhes das tarefas do BigQuery e detalhes ao nível do sistema. Para ver as autorizações exatas que são necessárias, expanda a secção Autorizações necessárias:
Autorizações necessárias
As seguintes autorizações são necessárias para trabalhar com detalhes das tarefas do BigQuery e detalhes ao nível do sistema:
-
Para ver dados ao nível do projeto:
bigquery.jobs.listAllno projeto -
Para ver dados ao nível da organização:
bigquery.jobs.listAllna organização -
Para filtrar por reservas na sua organização:
bigquery.reservations.listna organização
Também pode conseguir estas autorizações com funções personalizadas ou outras funções predefinidas.
Compreenda a comparação do desempenho de tarefas
As secções seguintes descrevem a página Comparação do desempenho do trabalho e as informações de resolução de problemas que fornece.
Pode ativar/desativar o botão Mostrar apenas diferenças significativas para ver apenas diferenças significativas entre os dois trabalhos para todas as métricas incluídas nesta página.
As diferenças significativas são realçadas a verde, amarelo e vermelho:
- Verde: a alteração move-se numa direção positiva. Por exemplo, como uma duração de consulta mais curta é melhor, se a tarefa de destino for executada mais rapidamente do que a tarefa de base, é marcada como verde.
- Amarelo: a alteração move-se numa direção negativa, mas a diferença é inferior a 20%.
- Vermelho: a alteração move-se numa direção negativa e a diferença é superior a 20%.
Análise ao nível da consulta
O painel Análise ao nível da consulta descreve as diferenças entre as duas tarefas ao nível da consulta. Contém três separadores: Métricas, Texto SQL e Gráfico de execução.
O separador Métricas descreve as métricas de consulta para as duas tarefas. Use este separador para determinar se existem discrepâncias entre a duração da tarefa, os aceleradores não usados e outras métricas.
O separador Texto SQL mostra as duas declarações SQL que criaram as tarefas e realça as diferenças entre elas. Use este separador para determinar se as alterações nas declarações SQL afetaram o desempenho da tarefa.
O separador Gráfico de execução compara os gráficos de execução das duas tarefas. Use este separador para determinar se ocorreram discrepâncias em qualquer fase durante a execução das tarefas.
Análise ao nível do sistema
O painel Análise ao nível do sistema descreve os fatores que podem afetar os dois trabalhos ao nível do sistema. É composto por três secções: a tabela Projeto, a tabela Reserva e a tabela Definições.
O painel Análise ao nível do sistema pode sugerir áreas de melhoria com base nas diferenças entre as duas consultas.
Por exemplo, se uma tarefa tiver recebido menos espaços do que as execuções anteriores, pode ser afetada por restrições de recursos no sistema. Se isto estiver indicado, verifique as métricas ao nível do projeto para ver se o projeto como um todo recebeu menos espaços. Se o projeto não tiver recebido menos vagas, é provável que tenha ocorrido uma disputa ao nível do projeto, como um aumento na concorrência de tarefas. Se o projeto recebeu menos vagas, verifique o nível de reserva para identificar restrições.
A tabela Projeto compara as duas tarefas ao nível do projeto. Use esta tabela para determinar se é possível fazer alguma otimização ao nível do projeto.
A tabela Reserva compara as duas tarefas ao nível da reserva. Use esta tabela para identificar diferenças na utilização de reservas entre as duas consultas que podem afetar o desempenho do trabalho.
A tabela Definições compara as definições de reserva entre as duas tarefas. Use esta tabela para detetar alterações às definições de reserva que possam ter causado um impacto no desempenho.
Compare dois empregos
Para comparar dois trabalhos:
Aceda à página Explorador de tarefas.
Opcional: filtre os empregos para restringir os empregos disponíveis apresentados.
Clique no ID da tarefa inicial que quer ver e comparar. É apresentada a página Detalhes da tarefa.
Clique no separador Desempenho.
Clique em Comparar trabalho.
No campo Tarefa 1 (tarefa de base), clique em Procurar. O painel Empregos comparáveis semelhantes é apresentado.
Identifique a tarefa com a qual quer comparar a tarefa de referência e clique em Comparar. É apresentada a comparação do desempenho do trabalho.
Para ver apenas as diferenças significativas entre os dois trabalhos, ative o botão Mostrar apenas diferenças significativas.
Altere os trabalhos que estão a ser comparados
Para alterar as tarefas que estão a ser comparadas:
Aceda à página Comparação do desempenho do trabalho.
No campo Tarefa 1 (tarefa de base), clique em Procurar.
No painel Tarefas comparáveis semelhantes, identifique a tarefa que quer comparar e clique em Comparar.
Preços
O explorador de trabalhos está disponível sem custo adicional. As consultas usadas para preencher estes gráficos não são faturadas e não usam espaços em reservas pertencentes ao utilizador. As consultas que processam demasiados dados excedem o tempo limite.
O que se segue?
- Saiba mais acerca das reservas.
- Saiba mais sobre a compra de espaços.
- Saiba como estimar os requisitos de capacidade de horários.
- Saiba como ver recomendações de slots e estatísticas.