Google BigQuery

公式ドキュメント

• Google BigQuery の詳細については、公式ドキュメントを参照してください。

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

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

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

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

   • データベースツールウィンドウで、ツールバーの 新規をクリックします。データソースに移動し、Google BigQuery を選択します。

   

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

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

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

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

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

      URL のみ 接続タイプの場合、入力した JDBC URL がそのまま使用され、データベース資格情報も含まれています。

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

   

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

   

   ダウンロードされた JDBC ドライバーの場所は WebStorm 構成ディレクトリです。

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

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

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

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

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

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

      • 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 データソース: アプリケーションのデフォルト資格情報を参照してください。

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

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

   5. 選択した認証方法に応じて、次の接続設定を指定します。

      Google サービスアカウント

      • サービスアカウントのメールアドレス : Google サービスアカウントのメールアドレス。

      • 鍵ファイル : サービスアカウントの秘密鍵ファイルへのフルパス。

      トークンへのアクセスと更新

      • アクセストークン : アクセストークン。

      • リフレッシュトークン : リフレッシュトークン。

      • クライアント ID : クライアント ID。

      • クライアントシークレット : クライアントシークレット。

      アプリケーションのデフォルト資格情報

      • サービスアカウントの鍵ファイル : サービスアカウントの秘密鍵ファイルへのフルパス。

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

   7. URL フィールドでは、WebStorm は他の接続設定の値を使用して 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 の公式ドキュメント(英語)」を参照してください。

   

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

      • 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 データソース: アプリケーションのデフォルト資格情報を参照してください。

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

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

   3. 選択した認証方法に応じて、次の接続設定を指定します。

      Google サービスアカウント

      • サービスアカウントのメールアドレス : Google サービスアカウントのメールアドレス。

      • 鍵ファイル : サービスアカウントの秘密鍵ファイルへのフルパス。

      トークンへのアクセスと更新

      • アクセストークン : アクセストークン。

      • リフレッシュトークン : リフレッシュトークン。

      • クライアント ID : クライアント ID。

      • クライアントシークレット : クライアントシークレット。

      アプリケーションのデフォルト資格情報

      • サービスアカウントの鍵ファイル : サービスアカウントの秘密鍵ファイルへのフルパス。

   4. URL フィールドでは、WebStorm は他の接続設定の値を使用して 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 の公式ドキュメント(英語)」を参照してください。

   

   一般およびデータソースおよびドライバーダイアログ (Shift+Enter) の他のタブの接続設定とプロパティに関する参考情報については、接続設定と DBMS 固有のプロパティを参照してください。

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

   

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

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

   

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

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

   • データベースツールウィンドウの詳細については、対応するリファレンストピックを参照してください。

   • WebStorm でのデータベースオブジェクトの操作の詳細については、「データベースオブジェクト」を参照してください。

   • クエリを記述して実行するには、データソースをクリックして F4 を押して、デフォルトのクエリファイルを開きます。

   • データベースオブジェクトのデータを表示および編集するには、オブジェクトをダブルクリックしてデータエディターとビューアーを開きます。