BigQuery API V2(Java)を使用して、
BigQueryテーブルの行(レコード)を取得する方法
についてご紹介します。

レコードの情報を取得するには、
適切なIAM権限が付与されている必要があります。

権限付与に関しては
⧉[BigQuery API(V2)] JavaでBigQueryを使う(2.権限付与)
を参照ください。

APIを利用する環境の準備から始める場合や、コードを実行する際は、
⧉[BigQuery API(V2)] JavaでBigQueryを使う
を参照ください。

No		目次
1		レコードを取得
	1	スコープ
	2	実行
	3	レスポンスの内容

1. レコードを取得

指定したテーブルのレコードを取得します。

1.1. スコープ

このAPIを実行するには、以下のいずれかのスコープを指定してください。

BigqueryScopes.BIGQUERY
BigqueryScopes.CLOUD_PLATFORM
BigqueryScopes.CLOUD_PLATFORM_READ_ONLY
https://www.googleapis.com/auth/bigquery.readonly

⧉[BigQuery API(V2)] JavaでBigQueryを使う(3.2. BigQueryインスタンスを取得)
でスコープを指定してください。

1.2. 実行

public static void main(String[] args) throws Exception{
    Bigquery bigquery = getBigquery();
    Bigquery.Tabledata tabledata = bigquery.tabledata();
    
    Bigquery.Tabledata.List list = tabledata.list("プロジェクトID","データセットID","テーブルID");
    
    TableDataList res = list.execute();
    System.out.println(res);
}

1.2.1. HTTPリクエスト

GET:　https://bigquery.googleapis.com/bigquery/v2/projects/{プロジェクトID}/datasets/{データセットID}/tables/{テーブルID}/data
が実行されます。

1.2.2. クエリパラメータ

Bigquery.Tabledata.Listのsetメソッドにより、クエリパラメータを追加できます。

メソッド	引数	説明
setMaxResults	Integer	結果の最大数
setPageToken	String	取得するページトークン
setStartIndex	String	取得する開始行インデックス
setSelectedFields	String	取得するフィールド
setFormatOptions	DataFormatOptions	出力フォーマットの調整

DataFormatOptions

メソッド	引数	説明
setUseInt64Timestamp	Boolean	タイムスタンプをusec int64として出力するか

1.3. レスポンスの内容

TableDataList

メソッド	戻り値	説明
getKind	String	リソースの種類固定文字列："bigquery#tableDataList"
getEtag	String	ハッシュ値
getPageToken	String	次のページトークン
getTotalRows	Long	テーブル全体の合計行数
getRows	List<TableRow>	行情報

TableRow

メソッド	戻り値	説明
get("フィールド名")	Object	指定したフィールド名のレコードの値を取得

おしまい。。