Antes do Looker 24.20, quando a autenticação OAuth para conexões do Google BigQuery estava sendo configurada, o Looker criava credenciais OAuth que permitiam ao usuário do banco de dados solicitar o escopo de leitura e gravação. A partir do Looker 24.20, o Looker solicita escopos somente leitura do OAuth para todas as novas conexões OAuth do BigQuery, novas autorizações do OAuth para conexões OAuth do BigQuery atuais e reautorizações para conexões OAuth do BigQuery atuais.
Observe o seguinte para conexões do Google BigQuery com escopos somente leitura:
- Os usuários não podem executar operações de gravação no SQL Runner.
- As conexões do Google BigQuery configuradas para autenticação OAuth não são compatíveis com o cancelamento de consultas.
A partir de 1º de março de 2025, o Looker vai desconectar todos os usuários que não tiverem feito a reautorização com escopos somente leitura do OAuth de todas as conexões correspondentes do BigQuery. Isso vai causar falhas em todas as programações que dependem dessas conexões. Cada um desses usuários precisará autorizar novamente as credenciais de conexão do OAuth para garantir a entrega ininterrupta da programação. Também é possível atribuir uma programação a um usuário que tenha reautorizado as credenciais de conexão OAuth.
Para garantir uma transição tranquila para as credenciais OAuth atualizadas, siga as etapas nas seções a seguir:
- Autorizar novamente as credenciais de conexão OAuth
- Gerar uma lista de todos os usuários com programações potencialmente afetadas
- (Opcional) Forçar o uso do escopo somente leitura na instância do Looker
Autorizar novamente as credenciais de conexão OAuth
Para atualizar suas credenciais do OAuth e usar um escopo somente leitura, siga estas etapas:
- Acesse a página Conta.
- Na seção Credenciais de conexão do OAuth, clique em Autorizar novamente ao lado de cada conjunto de credenciais.
- Será preciso autorizar novamente o Looker a acessar os dados do BigQuery. A tela de confirmação precisa listar a permissão "Ver seus dados no Google BigQuery" em vez de "Ver e gerenciar seus dados no Google BigQuery".
Cada usuário que tiver credenciais OAuth para a conexão do BigQuery precisará concluir essas etapas.
Gerar uma lista de todos os usuários com programações potencialmente afetadas
Para gerar uma lista de todos os usuários sem credenciais OAuth somente leitura que criaram programações nas suas conexões do BigQuery, acesse a seguinte Análise de Atividade do Sistema, substituindo INSTANCE_NAME pelo endereço da sua instância do Looker (como https://example.cloud.looker.com).
INSTANCE_NAME/explore/system__activity/scheduled_plan_oauth_events?fields=user.name,count,query.model&f[query.model]=-NULL&f[count]=0&sorts=user.name&limit=500&column_limit=50&query_timezone=America%2FLos_Angeles&vis=%7B%22show_view_names%22%3Afalse%2C%22show_row_numbers%22%3Atrue%2C%22transpose%22%3Afalse%2C%22truncate_text%22%3Atrue%2C%22hide_totals%22%3Afalse%2C%22hide_row_totals%22%3Afalse%2C%22size_to_fit%22%3Atrue%2C%22table_theme%22%3A%22white%22%2C%22limit_displayed_rows%22%3Afalse%2C%22enable_conditional_formatting%22%3Afalse%2C%22header_text_alignment%22%3A%22left%22%2C%22header_font_size%22%3A12%2C%22rows_font_size%22%3A12%2C%22conditional_formatting_include_totals%22%3Afalse%2C%22conditional_formatting_include_nulls%22%3Afalse%2C%22x_axis_gridlines%22%3Afalse%2C%22y_axis_gridlines%22%3Atrue%2C%22show_y_axis_labels%22%3Atrue%2C%22show_y_axis_ticks%22%3Atrue%2C%22y_axis_tick_density%22%3A%22default%22%2C%22y_axis_tick_density_custom%22%3A5%2C%22show_x_axis_label%22%3Atrue%2C%22show_x_axis_ticks%22%3Atrue%2C%22y_axis_scale_mode%22%3A%22linear%22%2C%22x_axis_reversed%22%3Afalse%2C%22y_axis_reversed%22%3Afalse%2C%22plot_size_by_field%22%3Afalse%2C%22trellis%22%3A%22%22%2C%22stacking%22%3A%22%22%2C%22legend_position%22%3A%22center%22%2C%22point_style%22%3A%22none%22%2C%22show_value_labels%22%3Afalse%2C%22label_density%22%3A25%2C%22x_axis_scale%22%3A%22auto%22%2C%22y_axis_combined%22%3Atrue%2C%22ordering%22%3A%22none%22%2C%22show_null_labels%22%3Afalse%2C%22show_totals_labels%22%3Afalse%2C%22show_silhouette%22%3Afalse%2C%22totals_color%22%3A%22%23808080%22%2C%22type%22%3A%22looker_grid%22%2C%22defaults_version%22%3A1%2C%22series_types%22%3A%7B%7D%2C%22hidden_fields%22%3A%5B%22count%22%5D%7D&filter_config=%7B%22query.model%22%3A%5B%7B%22type%22%3A%22%21null%22%2C%22values%22%3A%5B%7B%7D%2C%7B%7D%5D%2C%22id%22%3A0%7D%5D%2C%22count%22%3A%5B%7B%22type%22%3A%22%3D%22%2C%22values%22%3A%5B%7B%22constant%22%3A%220%22%7D%2C%7B%7D%5D%2C%22id%22%3A1%7D%5D%2C%22__%21internal%21__%22%3A%5B%22OR%22%2C%5B%5B%22AND%22%2C%5B%5B%22FILTER%22%2C%7B%22field%22%3A%22query.model%22%2C%22value%22%3A%22-NULL%22%2C%22type%22%3A%22%21null%22%7D%5D%2C%5B%22FILTER%22%2C%7B%22field%22%3A%22count%22%2C%22value%22%3A%220%22%7D%5D%5D%5D%5D%5D%7D&dynamic_fields=%5B%7B%22category%22%3A%22measure%22%2C%22expression%22%3Anull%2C%22label%22%3A%22Count%22%2C%22value_format%22%3Anull%2C%22value_format_name%22%3Anull%2C%22based_on%22%3A%22event_attribute.value%22%2C%22_kind_hint%22%3A%22measure%22%2C%22measure%22%3A%22count%22%2C%22type%22%3A%22count_distinct%22%2C%22_type_hint%22%3A%22number%22%2C%22filters%22%3A%7B%22event_attribute.value%22%3A%22%25%2Fauth%2Fbigquery.readonly%25%22%7D%7D%5D&origin=share-expanded
Cada um desses usuários precisará autorizar novamente as credenciais de conexão do OAuth para garantir a entrega ininterrupta da programação.
(Opcional) Forçar o uso do escopo somente leitura na instância do Looker
Para desconectar todos os usuários que têm credenciais OAuth que permitem o escopo de leitura e gravação de qualquer uma das suas conexões do BigQuery, siga estas etapas:
- Acesse a página Configurações do administrador - Configurações gerais.
- Ative a configuração Forçar o uso do escopo somente leitura do BigQuery e clique em Atualizar.
Esse processo não faz login dos usuários novamente no BigQuery. Seus usuários vão precisar fazer login no BigQuery na próxima vez que executarem uma consulta baseada em um modelo com uma conexão do BigQuery. As programações que dependem dessas conexões vão falhar até que o usuário faça login. Você também pode reatribuir uma programação para você ou outro usuário que já tenha reautorizado as credenciais de conexão OAuth.
Entregas programadas e acesso temporário
Quando uma conexão de banco de dados usa o OAuth, as entregas programadas são executadas com as credenciais do OAuth do usuário que é proprietário da programação. As ferramentas de gerenciamento de acesso temporário, como o acesso just-in-time, podem revogar os papéis do Identity and Access Management (IAM) de um usuário ou invalidar tokens OAuth após um período definido. Quando o acesso temporário ou o token OAuth de um proprietário de programação expira, as entregas programadas falham com um erro OAuth log in required.