# Google BigQuery

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/clion/llms.txt).

Procedure: データベースツールおよび SQL プラグインを有効化

この機能は、CLion にデフォルトでバンドルされ有効化されている データベースツールおよび SQL プラグインに依存しています。 関連機能が利用できない場合は、プラグインを無効化していないことを確認してください。

1. `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) を押して設定を開き、  `プラグイン`  を選択します。

2. データベースツールおよび SQL  プラグインを見つけて   有効化   をクリックします。

Procedure: 公式ドキュメント

* Google BigQuery の詳細については、 [公式ドキュメント](https://cloud.google.com/bigquery/docs)を参照してください。

### 始める前に

このトピックでは、CLion で Google BigQuery データベースへの [接続](connecting-to-a-database.html)用データソースを作成し、テスト接続を実行する一般的なプロシージャを説明します。 必要な接続の詳細がすでに用意されており、データベースが稼働していることを前提としています。

DBMS ソフトウェアの詳細については、 [公式ドキュメント](#official_information_links)を参照してください。

### 前提条件

|  認証方式  |  前提条件  |
| --- | --- |
|  Google サービスアカウント  |      * プロジェクト ID    * サービスアカウントのメール識別子    * 秘密鍵を含む JSON ファイル    |
|  トークンへのアクセスと更新  |      * トークンへのアクセスと更新    * クライアント ID    * クライアントシークレット    |

Procedure: Google BigQuery データベースに接続する

データベースに接続するには、接続の詳細を保存するデータソースを作成します。

1. 作成したいデータソースを選択します。 以下のいずれかの方法で選択できます。

* メインメニューで、 `ファイル | 新規 | データソース` に移動し、 Google BigQuery を選択します。

* データベース ツールウィンドウで、ツールバーの ![新しいアイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 新規 をクリックします。 データソース に移動し、 Google BigQuery を選択します。

![新しいデータソースを作成する](https://resources.jetbrains.com/help/img/idea/2026.3/create_new_data_source.png)

2. データソースおよびドライバー   ダイアログの右ペインの   一般   タブで、ドライバーと接続タイプを指定します。

1.

接続に別のドライバーが必要でない限り、   ドライバー   リストではデフォルトのドライバーオプションのままにしておきます。

2.

接続タイプ   リストから、接続の詳細に応じて接続タイプを選択します。

* デフォルト : ホスト 、 ポート 、 プロジェクト ID 、 デフォルトのデータセット 、 URL を使用して接続します。

* URL のみ : URL のみを使用して接続します。

URL のみ   [接続タイプ](data-sources-and-drivers-dialog.html#connection_type)の場合、データベース資格情報を含め、入力した JDBC URL がそのまま使用されます。

> **Note:**
> URL のみ   接続タイプの場合、JDBC URL はプレーンテキストでそのまま保存され、 [IDE ログファイル](troubleshooting-materials.html#locate-ide-log)および [データソース情報](managing-data-sources.html#share-data-sources-between-different-ide-instances)でも使用できます。

他の接続タイプの場合、JDBC URL は接続の詳細に分割されます。 個別に指定して自動生成された URL を使用することも、対応するフィールドに URL を直接入力することもできます。

![データソースとドライバーの全般タブダイアログ](https://resources.jetbrains.com/help/img/idea/2026.3/db_connection_general_tab.png)

3. 接続設定エリアの下部に「   不足しているドライバーファイルをダウンロード   」リンクがあるかどうかを確認してください。 このリンクをクリックすると、データベースとのやり取りに必要なドライバーをダウンロードできます。 直接ダウンロードリンクについては、 [JetBrains JDBC ドライバー](https://www.jetbrains.com/ja-jp/datagrip/jdbc-drivers/)ページを参照してください。

![不足しているドライバーファイルのダウンロードリンク](https://resources.jetbrains.com/help/img/idea/2026.3/db_connection_download_missing_drivers_link.png)

ダウンロードされた JDBC ドライバーの場所は [CLion 構成ディレクトリ](directories-used-by-the-ide-to-store-settings-caches-plugins-and-logs.html#config-directory)です。

提供されているドライバーの代わりにデータベース用のドライバーを使用することもできます。 ドライバーを使用したデータベースへの接続の詳細については、「 [既存の接続にユーザードライバーを追加する](jdbc-drivers.html#configure_a_jdbc_driver_for_an_existing_data_source)」を参照してください。

不足しているドライバーファイルをダウンロード   リンクがない場合は、必要なドライバーがすでに存在します。

4. データベース接続の詳細を指定します。 あるいは、JDBC URL を   URL   フィールドに貼り付けます。

デフォルト:

1.    ホスト   フィールドに、サーバーのアドレスを入力します。

2.

ポート   フィールドに Google BigQuery のポート番号を入力します。 デフォルトのポートは 443 です。

> **Note:**
> 実際のポート番号はシステムによって異なる場合があります。 データベース管理者、サーバー設定、ホスティングプロバイダーに正しいポート番号を使用していることを確認してください。

3.

認証   ドロップダウンから、接続の認証に使用する認証方法を選択します。 次のオプションを使用できます：

* Google サービスアカウント : Google サービスアカウントのメールアドレスとサービスアカウントの秘密鍵ファイルへのフルパスを使用します。 データソース作成のチュートリアルについては、 [Google BigQuery データソース: Google サービスアカウント](connect-to-bigquery.html#google-service-account)を参照してください。

* Google ユーザーアカウント : Google ユーザーアカウントの資格情報を提供してサーバーに接続します。 この方法では、データベースに接続するたびに認証が必要になります。 データソース作成のチュートリアルについては、 [Google BigQuery データソース: Google ユーザーアカウント](connect-to-bigquery.html#google-user-account)を参照してください。

* トークンへのアクセスと更新 : Google 認証サーバーからすでに生成されているアクセストークンまたはリフレッシュトークンを使用します。 リフレッシュトークンには、クライアント ID とクライアントシークレットも必要です。 トークンの詳細については、「 [OAuth2.0 を使用して developers.google.com で GoogleAPI にアクセスする(英語)](https://developers.google.com/identity/protocols/OAuth2)」を参照してください。 データソース作成のチュートリアルについては、 [Google BigQuery データソース: トークンへのアクセスと更新 (OAuth 2.0)](connect-to-bigquery.html#connecting-with-access-and-refresh-tokens-oauth-2-0)を参照してください。

* アプリケーションのデフォルト資格情報 : アプリケーションのデフォルト認証情報 (ADC) を通じて取得した認証情報を使用します。 ADC とその入手方法の詳細については、「 [cloud.google.com でサービスアカウントとして認証する](https://cloud.google.com/docs/authentication/production)」を参照してください。 データソース作成のチュートリアルについては、 [Google BigQuery データソース: アプリケーションのデフォルト資格情報](connect-to-bigquery.html#application-default-credentials)を参照してください。

* 認証なし : 認証は必要ありません。

4.  「   プロジェクト ID   」フィールドに、プロジェクトの一意の識別子を入力します。

5.

選択した認証メソッドに応じて、次の接続設定を指定します：

Google サービスアカウント
: * サービスアカウントのメールアドレス : Google サービスアカウントのメールアドレス。
:
: * 鍵ファイル : サービスアカウントの秘密鍵ファイルへのフルパス。

トークンへのアクセスと更新
: * アクセストークン : アクセストークン。
:
: * リフレッシュトークン : リフレッシュトークン。
:
: * クライアント ID : クライアント ID。
:
: * クライアントシークレット : クライアントシークレット。

アプリケーションのデフォルト資格情報
: * サービスアカウントの鍵ファイル : サービスアカウントの秘密鍵ファイルへのフルパス。

6.    デフォルトのデータセット   フィールドに、接続するデフォルトデータセットの名前を指定します。

7.

URL   フィールドでは、CLion は他の接続設定の値を使用して 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 公式ドキュメント](https://storage.googleapis.com/simba-bq-release/jdbc/Simba%20Google%20BigQuery%20JDBC%20Connector%20Install%20and%20Configuration%20Guide.pdf)を参照してください。

![データベース接続の詳細](https://resources.jetbrains.com/help/img/idea/2026.3/db_connection_details_bigquery_default.png)

URL のみ:

1.

認証   ドロップダウンから、接続の認証に使用する認証方法を選択します。 次のオプションを使用できます：

* Google サービスアカウント : Google サービスアカウントのメールアドレスとサービスアカウントの秘密鍵ファイルへのフルパスを使用します。 データソース作成のチュートリアルについては、 [Google BigQuery データソース: Google サービスアカウント](connect-to-bigquery.html#google-service-account)を参照してください。

* Google ユーザーアカウント : Google ユーザーアカウントの資格情報を提供してサーバーに接続します。 この方法では、データベースに接続するたびに認証が必要になります。 データソース作成のチュートリアルについては、 [Google BigQuery データソース: Google ユーザーアカウント](connect-to-bigquery.html#google-user-account)を参照してください。

* トークンへのアクセスと更新 : Google 認証サーバーからすでに生成されているアクセストークンまたはリフレッシュトークンを使用します。 リフレッシュトークンには、クライアント ID とクライアントシークレットも必要です。 トークンの詳細については、「 [OAuth2.0 を使用して developers.google.com で GoogleAPI にアクセスする(英語)](https://developers.google.com/identity/protocols/OAuth2)」を参照してください。 データソース作成のチュートリアルについては、 [Google BigQuery データソース: トークンへのアクセスと更新 (OAuth 2.0)](connect-to-bigquery.html#connecting-with-access-and-refresh-tokens-oauth-2-0)を参照してください。

* アプリケーションのデフォルト資格情報 : アプリケーションのデフォルト認証情報 (ADC) を通じて取得した認証情報を使用します。 ADC とその入手方法の詳細については、「 [cloud.google.com でサービスアカウントとして認証する](https://cloud.google.com/docs/authentication/production)」を参照してください。 データソース作成のチュートリアルについては、 [Google BigQuery データソース: アプリケーションのデフォルト資格情報](connect-to-bigquery.html#application-default-credentials)を参照してください。

* 認証なし : 認証は必要ありません。

2.  「   プロジェクト ID   」フィールドに、プロジェクトの一意の識別子を入力します。

3.

選択した認証メソッドに応じて、次の接続設定を指定します：

Google サービスアカウント
: * サービスアカウントのメールアドレス : Google サービスアカウントのメールアドレス。
:
: * 鍵ファイル : サービスアカウントの秘密鍵ファイルへのフルパス。

トークンへのアクセスと更新
: * アクセストークン : アクセストークン。
:
: * リフレッシュトークン : リフレッシュトークン。
:
: * クライアント ID : クライアント ID。
:
: * クライアントシークレット : クライアントシークレット。

アプリケーションのデフォルト資格情報
: * サービスアカウントの鍵ファイル : サービスアカウントの秘密鍵ファイルへのフルパス。

4.

URL   フィールドでは、CLion は他の接続設定の値を使用して 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 公式ドキュメント](https://storage.googleapis.com/simba-bq-release/jdbc/Simba%20Google%20BigQuery%20JDBC%20Connector%20Install%20and%20Configuration%20Guide.pdf)を参照してください。

> **Warning:**
> URL のみ   接続タイプの場合、   URL   フィールドの内容はプレーンテキストで保存され、 [IDE ログファイル](troubleshooting-materials.html#locate-ide-log)および [データソース設定ファイル](managing-data-sources.html#locate_the_datasources_xml_file)でも使用できます。
>
>
>
> 機密性の高い接続の詳細を   URL   フィールドに入力するのではなく、指定されたフィールドを使用して入力します。

![データベース接続の詳細](https://resources.jetbrains.com/help/img/idea/2026.3/db_connection_details_bigquery_urlonly.png)

一般   および   データソースおよびドライバー   ダイアログ ( `Shift+Enter` (Windows), `⌘ I` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Shift+Enter` (Sublime Text), `⌘ I` (Sublime Text (macOS)), `⌘ I` (Xcode), `Shift+Enter` (Visual Studio), `⌘ I` (Visual Studio (macOS)), `Shift+Enter` (ReSharper), `⌘ I` (ReSharper (macOS)), `Shift+Enter` (QtCreator), `Shift+Enter` (QtCreator (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⌘ I` (Eclipse (macOS)) ) の他のタブの接続設定とプロパティに関する参考情報については、 [接続設定と DBMS 固有のプロパティ](#reference)を参照してください。

5. 提供された詳細情報を使用してデータベース接続を確立できることを確認してください。 これを行うには、接続詳細セクションの下部にある   接続のテスト   リンクをクリックしてください。

![テスト接続リンク](https://resources.jetbrains.com/help/img/idea/2026.3/db_test_connection_link.png)

接続の問題が発生した場合は、 [データベースに接続できません](connectivity-problems.html)ページを参照してください。

6. (オプション) デフォルトでは、デフォルトのプロジェクトとデータセットのみがイントロスペクトされ、作業に使用できます。 他のプロジェクトやデータセットも操作したい場合は、   スキーマ   タブで、イントロスペクション用に選択します。

![データソースとドライバーの「スキーマ」タブダイアログ](https://resources.jetbrains.com/help/img/idea/2026.3/db_connection_schemas_tab.png)

7. OK   をクリックして、データソースを作成します。

8. データベース   ツールウィンドウで新しいデータソースを見つけます。

* データベース ツールウィンドウの詳細については、対応する [リファレンストピック](database-tool-window.html)を参照してください。 > **Tip:** > 新しいデータソースノードにさらに多くのプロジェクトとデータセットを表示するには、 N/M ボタンをクリックして必要なものを選択します。 CLion はそれらをイントロスペクトして表示します。 > > > > ![イントロスペクトしてデータベースツールウィンドウに表示するデータベースとスキーマを選択する](https://resources.jetbrains.com/help/img/idea/2026.3/connection_flow_show_databases_and_schemas.png)

* CLion でのデータベースオブジェクトの操作の詳細については、 [データベースオブジェクト](database-objects.html)を参照してください。

* クエリを作成して実行するには、データソースをクリックして `F4` (Windows), `⌘ ↓` (macOS), `F4` (IntelliJ IDEA Classic (macOS)), `F4` (macOS System Shortcuts), `F4` (XWin), `F4` (GNOME), `F4` (KDE), `F4` (Emacs), `F4` (Sublime Text), `F4` (Sublime Text (macOS)), `⌘ ↓` (Xcode), `F4` (Visual Studio), `⌘ ↓` (Visual Studio (macOS)), `F4` (ReSharper), `⌘ ↓` (ReSharper (macOS)), `F4` (QtCreator), `F4` (QtCreator (macOS)), `F4` (NetBeans), `F12` (Eclipse), `F3` (Eclipse (macOS)) を押し、デフォルトの [クエリコンソール](query-consoles.html)を開きます。

* データベースオブジェクトのデータを表示および編集するには、オブジェクトを double クリックして [データエディターダイアログ](data-editor-and-viewer.html)を開きます。

## 接続設定と DBMS 固有のプロパティ

### 接続設定

一般   および   データソースおよびドライバー   ダイアログ ( `Shift+Enter` (Windows), `⌘ I` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Shift+Enter` (Sublime Text), `⌘ I` (Sublime Text (macOS)), `⌘ I` (Xcode), `Shift+Enter` (Visual Studio), `⌘ I` (Visual Studio (macOS)), `Shift+Enter` (ReSharper), `⌘ I` (ReSharper (macOS)), `Shift+Enter` (QtCreator), `Shift+Enter` (QtCreator (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⌘ I` (Eclipse (macOS)) ) の他のタブの接続設定 (   ホスト   、   ポート   など) に関する参考情報については、「 [データソース](data-sources-and-drivers-dialog.html#db)」を参照してください。

### DBMS 固有のプロパティ

#### 一般タブ

|  項目  |  説明  |  認証方式  |
| --- | --- | --- |
|  プロジェクト ID  |     プロジェクトの一意の識別子。     |      * Google サービスアカウント    * Google ユーザーアカウント    * トークンへのアクセスと更新    * アプリケーションのデフォルト資格情報    |
|  サービスアカウントのメールアドレス  |     Google サービスアカウントの E メールアドレス。     |    Google サービスアカウント    |
|  キーファイルとサービスアカウントキーファイル  |     サービスアカウントの秘密鍵ファイルへのフルパス。     |      * Google サービスアカウント    * アプリケーションのデフォルト資格情報    |
|  アクセストークン  |     生成するアクセストークン。     |    トークンへのアクセスと更新    |
|  リフレッシュトークン  |     生成するリフレッシュトークン。     |
|  クライアント ID  |     生成する Google クライアント ID。     |
|  クライアントシークレット  |     生成する Google クライアントシークレット。     |
|  デフォルトのデータセット  |     デフォルトデータセットの名前。     |      * Google サービスアカウント    * Google ユーザーアカウント    * トークンへのアクセスと更新    * アプリケーションのデフォルト資格情報    |

## See also

### リファレンス

[データソースとその要素](database-tool-window.html#icons-for-data-sources-and-their-elements) [データソースおよびドライバーダイアログ](data-sources-and-drivers-dialog.html)

### ツールウィンドウ

[データベースツールウィンドウ](database-tool-window.html)

