Google BigQuery
公式ドキュメント
Google BigQuery の詳細については、 公式ドキュメントを参照してください。
始める前に
このトピックでは、DataGrip で Google BigQuery データベースへの 接続用データソースを作成し、テスト接続を実行する一般的な手順を説明します。 必要な接続の詳細がすでに用意されており、データベースが稼働していることを前提としています。
DBMS ソフトウェアの詳細については、 公式ドキュメントを参照してください。
前提条件
認証方式 | 前提条件 |
|---|---|
Google サービスアカウント |
|
アクセスおよびリフレッシュトークン |
|
Google BigQuery データベースに接続する
データベースに接続するには、接続の詳細を保存するデータソースを作成します。
作成したいデータソースを選択します。 以下のいずれかの方法で選択できます。
メインメニューで、 に移動し、 Google BigQuery を選択します。
データベースエクスプローラー (⌘ 1) で、ツールバーの
新規 をクリックします。 データソース に移動し、 Google BigQuery を選択します。

データソースおよびドライバー ダイアログの右ペインの 一般 タブで、ドライバーと接続タイプを指定します。
接続に別のドライバーが必要でない限り、 ドライバー リストではデフォルトのドライバーオプションのままにしておきます。
接続タイプ リストから、接続の詳細に応じて接続タイプを選択します。
デフォルト: ホスト、 ポート、 プロジェクト ID、 デフォルトのデータセット、 URL を使用して接続します。
URL のみ: URL のみを使用して接続します。
URL のみ 接続タイプの場合、データベース資格情報を含め、入力した JDBC URL がそのまま使用されます。
他の接続タイプの場合、JDBC URL は接続の詳細に分割されます。 個別に指定して自動生成された URL を使用することも、対応するフィールドに URL を直接入力することもできます。

接続設定エリアの下部に「不足しているドライバーファイルのダウンロード 」リンクがあるかどうかを確認してください。 このリンクをクリックすると、データベースとのやり取りに必要なドライバーをダウンロードできます。 直接ダウンロードリンクについては、 JetBrains JDBC ドライバーページを参照してください。

ダウンロードされた JDBC ドライバーの場所は DataGrip 構成ディレクトリです。
提供されているドライバーの代わりにデータベース用のドライバーを使用することもできます。 ドライバーを使用したデータベースへの接続の詳細については、「既存の接続にユーザードライバーを追加する 」を参照してください。
不足しているドライバーファイルのダウンロード リンクがない場合は、必要なドライバーがすでに存在します。
データベース接続の詳細を指定します。 あるいは、JDBC URL を URL フィールドに貼り付けます。
ホスト フィールドに、サーバーのアドレスを入力します。
ポート フィールドに Google BigQuery のポート番号を入力します。 デフォルトのポートは 443 です。
認証 ドロップダウンから、接続の認証に使用する認証方法を選択します。 次のオプションを使用できます:
Google サービスアカウント: Google サービスアカウントのメールアドレスとサービスアカウントの秘密鍵ファイルへのフルパスを使用します。
データソース作成のチュートリアルについては、 Google BigQuery データソース: Google サービスアカウントを参照してください。
Google ユーザーアカウント: Google ユーザーアカウントの資格情報を提供してサーバーに接続します。 この方法では、データベースに接続するたびに認証が必要になります。
データソース作成のチュートリアルについては、 Google BigQuery データソース: Google ユーザーアカウントを参照してください。
アクセスおよびリフレッシュトークン: Google 認証サーバーからすでに生成されているアクセストークンまたはリフレッシュトークンを使用します。 リフレッシュトークンには、クライアント ID とクライアントシークレットも必要です。 トークンの詳細については、「OAuth2.0 を使用して developers.google.com で GoogleAPI にアクセスする(英語) 」を参照してください。
データソース作成のチュートリアルについては、 Google BigQuery データソース: アクセスおよびリフレッシュトークン(OAuth 2.0)を参照してください。
アプリケーションのデフォルト資格情報: アプリケーションのデフォルト認証情報 (ADC) を通じて取得した認証情報を使用します。 ADC とその入手方法の詳細については、「cloud.google.com でサービスアカウントとして認証する 」を参照してください。
データソース作成のチュートリアルについては、 Google BigQuery データソース: アプリケーションのデフォルト資格情報を参照してください。
認証なし: 認証は必要ありません。
「プロジェクト ID 」フィールドに、プロジェクトの一意の識別子を入力します。
選択した認証方法に応じて、次の接続設定を指定します:
- Google サービスアカウント
サービスアカウントのメールアドレス: Google サービスアカウントのメールアドレス。
鍵ファイル: サービスアカウントの秘密鍵ファイルへのフルパス。
- アクセスおよびリフレッシュトークン
アクセストークン: アクセストークン。
リフレッシュトークン: リフレッシュトークン。
クライアント ID: クライアント ID。
クライアントシークレット: クライアントシークレット。
- アプリケーションのデフォルト資格情報
サービスアカウントの鍵ファイル: サービスアカウントの秘密鍵ファイルへのフルパス。
デフォルトのデータセット フィールドに、接続するデフォルトデータセットの名前を指定します。
URL フィールドでは、DataGrip は他の接続設定の値を使用して JDBC URL を自動的に生成します。
特定の追加設定を含む JDBC URL を使用する必要がある場合は、それを URL フィールドに貼り付けます。 一般的な URL は次のとおりです。
フォーマット:
jdbc:bigquery://https://<host_address>:<port_number>;DefaultDataset=<dataset_name>サンプル:
jdbc:bigquery://https://www.googleapis.com/bigquery/v2:443;DefaultDataset=myDataset
URL 形式の詳細については、 Google BigQuery の公式ドキュメントを参照してください。

認証 ドロップダウンから、接続の認証に使用する認証方法を選択します。 次のオプションを使用できます:
Google サービスアカウント: Google サービスアカウントのメールアドレスとサービスアカウントの秘密鍵ファイルへのフルパスを使用します。
データソース作成のチュートリアルについては、 Google BigQuery データソース: Google サービスアカウントを参照してください。
Google ユーザーアカウント: Google ユーザーアカウントの資格情報を提供してサーバーに接続します。 この方法では、データベースに接続するたびに認証が必要になります。
データソース作成のチュートリアルについては、 Google BigQuery データソース: Google ユーザーアカウントを参照してください。
アクセスおよびリフレッシュトークン: Google 認証サーバーからすでに生成されているアクセストークンまたはリフレッシュトークンを使用します。 リフレッシュトークンには、クライアント ID とクライアントシークレットも必要です。 トークンの詳細については、「OAuth2.0 を使用して developers.google.com で GoogleAPI にアクセスする(英語) 」を参照してください。
データソース作成のチュートリアルについては、 Google BigQuery データソース: アクセスおよびリフレッシュトークン(OAuth 2.0)を参照してください。
アプリケーションのデフォルト資格情報: アプリケーションのデフォルト認証情報 (ADC) を通じて取得した認証情報を使用します。 ADC とその入手方法の詳細については、「cloud.google.com でサービスアカウントとして認証する 」を参照してください。
データソース作成のチュートリアルについては、 Google BigQuery データソース: アプリケーションのデフォルト資格情報を参照してください。
認証なし: 認証は必要ありません。
「プロジェクト ID 」フィールドに、プロジェクトの一意の識別子を入力します。
選択した認証方法に応じて、次の接続設定を指定します:
- Google サービスアカウント
サービスアカウントのメールアドレス: Google サービスアカウントのメールアドレス。
鍵ファイル: サービスアカウントの秘密鍵ファイルへのフルパス。
- アクセスおよびリフレッシュトークン
アクセストークン: アクセストークン。
リフレッシュトークン: リフレッシュトークン。
クライアント ID: クライアント ID。
クライアントシークレット: クライアントシークレット。
- アプリケーションのデフォルト資格情報
サービスアカウントの鍵ファイル: サービスアカウントの秘密鍵ファイルへのフルパス。
URL フィールドでは、DataGrip は他の接続設定の値を使用して JDBC URL を自動的に生成します。
特定の追加設定を含む JDBC URL を使用する必要がある場合は、それを URL フィールドに貼り付けます。 一般的な URL は次のとおりです。
フォーマット:
jdbc:bigquery://https://<host_address>:<port_number>;DefaultDataset=<dataset_name>サンプル:
jdbc:bigquery://https://www.googleapis.com/bigquery/v2:443;DefaultDataset=myDataset
URL 形式の詳細については、 Google BigQuery の公式ドキュメントを参照してください。

一般 および データソースおよびドライバー ダイアログ (Ctrl+Alt+Shift+S) の他のタブの接続設定とプロパティに関する参考情報については、 接続設定と DBMS 固有のプロパティ を参照してください。
提供された詳細情報を使用してデータベース接続を確立できることを確認してください。 これを行うには、接続詳細セクションの下部にある 接続のテスト リンクをクリックしてください。

接続の問題が発生した場合は、 データベースに接続できません ページを参照してください。
(オプション) デフォルトでは、デフォルトのプロジェクトとデータセットのみがイントロスペクトされ、作業に使用できます。 他のプロジェクトやデータセットも操作したい場合は、 スキーマ タブで、イントロスペクション用に選択します。

OK をクリックして、データソースを作成します。
データベースエクスプローラー (⌘ 1) で新しいデータソースを見つけます。
データベースエクスプローラー の詳細については、対応する リファレンストピックを参照してください。
DataGrip でのデータベースオブジェクトの操作の詳細については、 データベースオブジェクト を参照してください。
クエリを作成して実行するには、データソースをクリックして F4 を押し、既定の クエリコンソールを開きます。
データベースオブジェクトのデータを表示および編集するには、オブジェクトをダブルクリックして データエディターとビューアー を開きます。
接続設定と DBMS 固有のプロパティ
接続設定
一般 および データソースおよびドライバー ダイアログ (Ctrl+Alt+Shift+S) の他のタブの接続設定 (ホスト、 ポート など) に関する参考情報については、「データソース 」を参照してください。
DBMS 固有のプロパティ
一般タブ
項目 | 説明 | 認証方式 |
|---|---|---|
プロジェクト ID | プロジェクトの一意の識別子。 |
|
サービスアカウントのメールアドレス | Google サービスアカウントのメールアドレス。 | Google サービスアカウント |
キーファイルとサービスアカウントキーファイル | サービスアカウントの秘密鍵ファイルへのフルパス。 |
|
アクセストークン | 生成されたアクセストークン。 | アクセスおよびリフレッシュトークン |
リフレッシュトークン | 生成されたリフレッシュトークン。 | |
クライアント ID | 生成された Google クライアント ID。 | |
クライアントシークレット | 生成された Google クライアントシークレット。 | |
デフォルトのデータセット | デフォルトのデータセットの名前。 |
|