Google BigQuery 接続の OAuth スコープを読み取り専用に制限する

Looker 24.20 より前では、Google BigQuery 接続の OAuth 認証が設定されると、Looker はデータベース ユーザーが読み取りスコープと書き込みスコープをリクエストできるようにする OAuth 認証情報を作成していました。Looker 24.20 以降では、Looker は、新しい BigQuery OAuth 接続、既存の BigQuery OAuth 接続への新しい OAuth 認可、既存の BigQuery OAuth 接続への再認可に対して、OAuth 読み取り専用スコープをリクエストします。

読み取り専用スコープの Google BigQuery 接続については、次の点に注意してください。

2025 年 3 月 1 日より、Looker は、OAuth の読み取り専用スコープで再認証していないユーザーを、対応するすべての BigQuery 接続からログアウトします。これにより、これらの接続に依存するスケジュールが失敗します。これらのユーザーは、スケジュール配信が中断されないように、OAuth 接続認証情報を再承認する必要があります。OAuth 接続認証情報を再承認したユーザーにスケジュールを再割り当てすることもできます。

更新された OAuth 認証情報にシームレスに移行するには、次のセクションの手順に沿って操作します。

OAuth 接続の認証情報を再承認する

読み取り専用スコープを使用するように OAuth 認証情報を更新する手順は次のとおりです。

  1. [アカウント] ページに移動します。
  2. [OAuth 接続認証情報] セクションで、各認証情報の横にある [再承認] をクリックします。
  3. BigQuery データへのアクセスを Looker に再承認するよう求められます。確認画面には、「Google BigQuery 内のデータの表示と管理」ではなく、「Google BigQuery 内のデータの表示」という権限が表示されます。

BigQuery 接続の OAuth 認証情報を持つ各ユーザーは、これらの手順を完了する必要があります。

影響を受ける可能性のあるスケジュールを持つすべてのユーザーのリストを生成する

BigQuery 接続でスケジュールを作成した、読み取り専用の OAuth 認証情報を持たないすべてのユーザーのリストを生成するには、次のシステム アクティビティ Explore にアクセスし、INSTANCE_NAME を Looker インスタンスのアドレス（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

これらの各ユーザーは、スケジュール配信が中断されないように、OAuth 接続認証情報を再承認する必要があります。

（省略可）Looker インスタンス全体で読み取り専用スコープの使用を強制する

BigQuery 接続から読み取り / 書き込みスコープを許可する OAuth 認証情報を持つすべてのユーザーをログアウトするには、次の手順を行います。

  1. [管理者設定 - 全般設定 ] ページに移動します。
  2. [Force BigQuery Readonly Scope usage] 設定を [Enabled] に切り替えて、[Update] をクリックします。

このプロセスでは、ユーザーは BigQuery に再度ログインしません。ユーザーが BigQuery 接続を使用するモデルに基づいてクエリを実行すると、BigQuery へのログインを求めるプロンプトが表示されます。これらの接続に依存するスケジュールは、ユーザーがログインするまで失敗します。また、OAuth 接続認証情報をすでに再承認している自分自身または別のユーザーにスケジュールを再割り当てすることもできます。