Google BigQuery 用コネクタ — 機能と設定
Google BigQuery に接続し、データにアクセスすることができます。このページでは、機能、利用可能な設定、および Google BigQuery へのデータ接続を行う際の注意事項に関する情報を提供しています。
ページ コンテンツ
ヒント: Google BigQuery への最初の接続を作成する方法や、Spotfire で BigQuery データを扱う方法については、「Google BigQuery からのデータへのアクセス」を参照してください。
コネクタの機能
Google BigQuery 用コネクタを使用してデータにアクセスすると、次の機能が利用可能になります。
| 機能 | サポートについて |
|---|---|
| ロードする方法 |
|
| カスタム クエリー | はい |
| ストアド プロシージャ | いいえ |
| カスタム接続のプロパティ | いいえ |
| ID プロバイダによるシングル サインオン | N/A |
| Web クライアントでのオーサリング | いいえ |
| Linux での Spotfire ディストリビューションに含まれます | はい |
データ ソース プロパティ
サポートされているデータ ソース プロパティは次のとおりで、Google BigQuery 用コネクタでデータ接続を作成する際に構成できます。
| オプション | 説明 |
|---|---|
| 請求プロジェクト | データ接続から BigQuery へのクエリーに対して料金を支払う Google Cloud Platform プロジェクトを選択します。 注:
ListAllProjects 設定は、選択した請求プロジェクトのみのデータを表示できるか、または Google BigQuery でアクセスできる (自分がメンバーになっているプロジェクトの) すべてのデータを表示できるかを決定します。管理者は、管理マネージャの [コネクタ] > [Google BigQuery] > [ListAllProjects] で設定を変更できます。
|
| 追加のプロジェクトからデータを含める | この設定は、次の 2 つの目的で使用できます。
|
| 繰り返しカラムを有効にする | データ ソースへの接続で繰り返しカラムを表示および選択できるかどうかを決定します。 Spotfire で繰り返しカラムを操作するには、データについてよく理解している必要があります。BigQuery の繰り返しカラムが Spotfire でどのように動作するかについては、「Google BigQuery の繰り返しカラム」を参照してください。 デフォルトでは、このチェック ボックスはオフになっています。[接続内のビュー] ダイアログで、繰り返しカラムが選択対象として表示されません。 注: BigQuery コネクタを使用して Google Analytics のデータにアクセスできるようにするには、接続で繰り返しカラムを有効にする必要があります。
|
| パブリック データを表示する | データ ソースへの接続で BigQuery パブリック データセットを表示および選択できるかどうかを決定します。 デフォルトでは、このチェック ボックスはオフになっています。[接続内のビュー] ダイアログで、BigQuery パブリック データセットのデータが選択対象として表示されません。 パブリック データを有効にすると、[接続のビュー] ダイアログでデータテーブルをロードするのに非常に長い時間がかかることがあります。 ヒント: Spotfire 管理者として、[パブリック データを表示する] をユーザーが利用できるかどうかを制御できます。パブリック データを選択するオプションをユーザーが使用できないようにするには、Spotfire 管理マネージャで、Google BigQuery の設定 [
ShowPublicDataCheckBox] を [False] に設定します。 |
| プライベート エンドポイントを使用する | Google BigQuery への接続にプライベート エンドポイントを使用するかどうかを選択します。これを行うには、[プライベート エンドポイント] タブをクリックします。プライベート エンドポイントは 5 つあり、設定から取得することも、カスタムで設定することもできます。「Google BigQuery のプライベート エンドポイント」を参照してください。 |
サポートされるデータ型
外部データ ソースとの接続をセットアップするときに、Spotfire ではデータ ソースのデータ型を対応する Spotfire のデータ型にマップする必要があります。以下は、Google BigQuery コネクタがサポートするデータ型です。
| データベースのデータ型 | Spotfire のデータ型 |
|---|---|
| BYTES | Binary |
| GEOGRAPHY | Binary |
| BOOL | Boolean/Bool |
| NUMERIC | Currency/Decimal |
| DATE | Date |
| DATETIME | DateTime |
| INT64 | LongInteger/Long |
| FLOAT64 | Real/Double |
| STRING | String |
| TIME | Time |
サポートされている関数
サポートされている関数は、計算カラムやカスタム式など、インデータベース データテーブルを操作するときに使用できる関数です。
注: サポートされている一部の関数は、データベースで使用できない場合があります。これは、データベースで使用できる関数によって異なります。それらの関数は、データベースのバージョンおよびタイプによって異なることがよくあります。
以下は、Google BigQuery コネクタがサポートする関数です。
| 関数の種類 | サポートされている機能 |
|---|---|
| 集計関数 | AVG、COUNT、COUNTIF、LOGICAL_AND、LOGICAL_OR、MAX、MIN、STRING_AGG、 SUM |
| 近似集計関数 | APPROX_COUNT_DISTINCT |
| ビット関数 | BIT_COUNT |
| 変換 | STRING |
| データ関数 | EXTRACT、DATE、DATE_ADD、DATE_SUB、DATE_DIFF、DATE_TRUNC、DATE_FROM_UNIX_DATE、FORMAT_DATE、PARSE_DATE、 UNIX_DATE |
| 日付および時刻関数 | DATETIME、DATETIME_ADD、DATETIME_SUB、DATETIME_DIFF、DATETIME_TRUNC、FORMAT_DATETIME、 PARSE_DATETIME |
| 地理関数 | ST_GEOGPOINT、ST_MAKELINE、ST_MAKEPOLYGON、ST_GEOGFROMGEOJSON、ST_GEOGFROMTEXT、ST_GEOGFROMWKB、ST_ASGEOJSON、ST_ASTEXT、ST_ASBINARY、ST_BOUNDARY、ST_CENTROID、ST_CLOSESTPOINT、ST_DIFFERENCE、ST_INTERSECTION、ST_SNAPTOGRID、ST_UNION、ST_X、ST_Y、ST_CONTAINS、ST_COVEREDBY、ST_COVERS、ST_DISJOINT、ST_DWITHIN、ST_EQUALS、ST_INTERSECTS、ST_INTERSECTSBOX、ST_TOUCHES、ST_WITHIN、ST_ISEMPTY、ST_ISCOLLECTION、ST_DIMENSION、ST_NUMPOINTS、ST_AREA、ST_DISTANCE、ST_LENGTH、ST_MAXDISTANCE、ST_PERIMETER、 ST_UNION_AGG |
| ハッシュ関数 | FARM_FINGERPRINT、MD5、SHA1、SHA256、 SHA512 |
| JSON 関数 | JSON_EXTRACT、JSON_EXTRACT_SCALAR、 TO_JSON_STRING |
| 数学関数 | ABS、SIGN、IS_INF、IS_NAN、IEEE_DIVIDE、RAND、SQRT、POW、POWER、EXP、LN、LOG、LOG10、GREATEST、LEAST、DIV、SAFE_DIVIDE、MOD、ROUND、TRUNC、CEIL、CEILING、FLOOR、COS、COSH、ACOS、ACOSH、SIN、SINH、ASIN、ASINH、TAN、TANH、ATAN、ATANH、 ATAN2 |
| 演算子 | +、-、*、 / |
| 統計集計関数 | CORR、COVAR_POP、COVAR_SAMP、STDDEV_POP、STDDEV_SAMP、STDDEV、VAR_POP、VAR_SAMP、 VARIANCE |
| 文字列関数 | BYTE_LENGTH、CHAR_LENGTH、CHARACTER_LENGTH、CONCAT、ENDS_WITH、FROM_BASE64、FROM_BASE32、FROM_HEX、LENGTH、LPAD、LOWER、LTRIM、NORMALIZE、NORMALIZE_AND_CASEFOLD、REGEXP_CONTAINS、REGEXP_EXTRACT、REGEXP_REPLACE、REPLACE、REPEAT、REVERSE、RPAD、RTRIM、SAFE_CONVERT_BYTES_TO_STRING、STARTS_WITH、SUBSTR、TO_BASE32、TO_BASE64、TO_HEX、 TRIM |
| 時刻関数 | TIME、TIME_ADD、TIME_SUB、TIME_DIFF、TIME_TRUNC、FORMAT_TIME、 PARSE_TIME |
| タイムスタンプ関数 | EXTRACT、STRING、TIMESTAMP、TIMESTAMP_ADD、TIMESTAMP_SUB、TIMESTAMP_DIFF、TIMESTAMP_TRUNC、FORMAT_TIMESTAMP、TIMESTAMP_SECONDS、TIMESTAMP_MILLIS、TIMESTAMP_MICROS、UNIX_SECONDS、UNIX_MILLIS、 UNIX_MICROS |
| UUID 関数 | GENERATE_UUID |