機械翻訳について

Google BigQueryのモデル・データ

Google BigQueryデータベースからデータをモデル化およびビジュアル化できるように、Google BigQueryデータベースに接続します。 セマンティック・モデラーまたはモデル管理ツールでGoogle BigQueryデータをモデリングできます。 これらのタスクでは、モデル管理ツールを使用したプロセスについて説明します。

トピック

Google BigQueryへのOracle Analytics接続の作成

Google BigQueryデータベースへのシステム接続を作成し、その接続を使用してGoogle BigQueryプロジェクトをモデル化できます。

開始する前に、Google BigQueryサービスのサービス・アカウント秘密キー(JSON形式)をダウンロードします。
  1. Oracle Analyticsの「ホーム」ページで、「作成」をクリックし、「接続」をクリックします。
  2. BigQueryをクリックします。
  3. 接続の詳細を入力します。
    • 「接続名」で、Oracle Analytics内の接続の詳細を識別するためのわかりやすい名前を指定します。
    • 「プロジェクト」で、分析するプロジェクトのBigQueryプロジェクト名を小文字で指定します。
    • 「サービス・アカウント秘密キー」で、「選択」をクリックし、BigQueryサービスのサービス・アカウント秘密キー(JSON形式)をアップロードします。 「サービス・アカウントEメール」は、アップロードされたキーの詳細から移入されます。
    • 「システム接続」で、このオプションを選択します。
      googlebq1.pngの説明は以下のとおりです
      図googlebq1.pngの説明

  4. 詳細を保存します。

BigQuery ODBCドライバのダウンロードおよび設定

Google BigQueryへの接続に必要なODBCドライバをインストールし、モデル管理ツールで構成して、プロジェクトをモデル化できるようにします。

  1. GoogleからSimba BigQuery ODBCドライバをダウンロードします。
    たとえば、「Googleリファレンス・サイト」からダウンロードします。
  2. ダウンロードしたドライバを、Oracle Analytics Client Toolsがインストールされているマシンにインストールします。
  3. 「DSN設定」ダイアログを使用してODBCドライバを構成します。
    googlebq2.pngの説明は以下のとおりです
    図googlebq2.pngの説明

  4. 「テスト」をクリックして、接続をテストします。
    googlebq3.pngの説明は以下のとおりです
    図googlebq3.pngの説明

  5. 詳細を保存します。

Google BigQueryデータ・ソースからのデータ・モデルの構築

Google BigQueryデータベースのデータ・モデルを構築して、それをデプロイしてBigQueryプロジェクトのデータをビジュアル化できるようにします。

データ・モデルを構築するには、BigQueryキーで権限が必要です。 BigQueryキーがデータセット・レベルへのアクセス権を付与する場合は、次のステップに従って、BigQuery ODBCドライバを使用して「メタデータのインポート」を実行します。 BigQueryキーが特定の表またはビューのみへのアクセス権を付与する場合は、次のステップに従って物理スキーマを作成します。
  1. モデル管理ツールで、リポジトリにデータベースを作成し、「データベース・タイプ」をODBC Basicに設定します。
    googlebq4.pngの説明は以下のとおりです
    図googlebq4.pngの説明

  2. 「接続プール」ダイアログで、データベースに接続プールを作成します。
    • 「コール・インタフェース」で、「デフォルト(ODBC 2.0)」を選択します。

    • 「データソース名」フィールドで、前に作成したBigQuery ODBCドライバを選択します。

  3. BigQueryデータセットと同じ名前を使用して、データベースに物理スキーマを作成します。
    BigQuery SQLでは、データセット名の先頭に表名dataset.tableを追加する必要があります。 データセット名は、リポジトリ・ファイル内の物理スキーマ・オブジェクトと同等です。
  4. 接続プールを右クリックして、「メタデータのインポート」を選択します。
  5. 「データソースの選択」ダイアログで、接続タイプとしてODBC 2.0またはODBC 3.5のいずれかを選択し、BigQuery ODBCドライバを選択します。
    googlebq7.pngの説明は以下のとおりです
    図googlebq7.pngの説明

  6. 「メタデータ・タイプの選択」ダイアログで、「ビュー」と、BigQueryキーに権限があるその他のタイプを選択します。
    googlebq8.pngの説明は以下のとおりです
    図googlebq8.pngの説明

  7. 「メタデータ・タイプの選択」ダイアログで、個々の表を選択し、「選択したインポート」をクリックします。 これにより、BigQueryデータベースと基礎となる構造がインポートされます。
    googlebq10.pngの説明は以下のとおりです
    図googlebq10.pngの説明

    「すべてインポート」をクリックすると、データベースのみがインポートされます。 これが起こった場合は、もう一度「すべてインポート」を選択すると表がインポートされます。
  8. 「終了」をクリックします。
  9. インポートした表を物理スキーマにドラッグします。
  10. 物理データベースを編集し、データベース・タイプをBigQueryに変更します。

    物理データベースを変更すると、データベース・タイプが接続プールで設定されたコール・インタフェースと一致しないことを示すメッセージが表示されます。 「はい」をクリックします。

  11. 「接続プール」ダイアログで、次の設定を構成します:
    • 「コール・インタフェース」で、コール・インタフェースをJDBC (ダイレクト・ドライバ)に変更します。
    • 「完全修飾表名が必要」を選択します。
    • 「データ接続を使用」を選択します。
    • Oracle Analyticsで、BigQuery接続を検査し、オブジェクトIDをコピーします。 BigQueryでは、大/小文字が区別されます。 正しいデータ接続構文を維持するために、「コピー」ボタンを使用します。
      googlebq14.pngの説明は以下のとおりです
      図googlebq14.pngの説明

    • 「接続プール」ダイアログで、コピーしたオブジェクトIDを「オブジェクトID」フィールドに貼り付けます。
    • 「最大接続数」を100に設定します。
  12. 詳細を保存します。
リポジトリ内のメタデータをモデル化し、リポジトリ・ファイル(RPD)をOracle Analyticsにアップロードします。

Google BigQueryに対するリポジトリ接続の問題のトラブルシューティング

ここでは、Google BigQueryへの接続時に発生する可能性のある問題とその回避方法について説明します。

「完全修飾表名が必要」が選択されておらず、物理スキーマが生成されたSQLの一部ではない場合、問合せは失敗し、「Javaデータソース・サーバーからのデータの読取りに失敗しました」のようなメッセージが表示されます。

nqcmdまたは別のSQLエントリ・ツールを使用してBigQueryに対して問合せを実行すると、実際のエラー・メッセージが表示されます:

WITH SAWITH0 AS (select distinct T4.PROP_CD as c1 from FINOPS_RM_OCC_ACT T4) select 0 as c1, D1.c1 as c2 from SAWITH0 D1 order by c2
[Simba][BigQuery] (70) Invalid query: Table "FINOPS_RM_OCC_ACT" must be qualified with a dataset (e.g. dataset.table).
Statement preparation failed

データセットで問合せを修飾する方法は、リポジトリ・ファイル内の物理スキーマを使用することです。

Oracle Analytics接続で大文字のプロジェクト名が使用されている場合、接続は正常に作成されます。

2つの異なる問題が表示される場合があります。

1. マスクされたURLに関する「404 Not Found」メッセージで問合せが失敗します:

[2022-03-17T01:13:44.105+00:00] [OBIS] [TRACE:2] [USER-34] [] [ecid: d6382db0-1e63-427e-893b-18bc00c0424e-0000de96,0:2:1:5] [sik: bootstrap] [tid: 856a6700] [messageId: USER-34] [requestid: 6358001e] [sessionid: 63580000] [username: Testuser] -------------------- Query Status: [nQSError: 46164] HTTP Server returned 404 (Not Found) for URL [masked_url]. [[
[nQSError: 46281] Failed to download metadata for dataset ‘system’.‘BigQuery Test’.
[nQSError: 43119] Query Failed:

2. Oracle Analyticsでは、データセットが表示されますが、基礎となる表は使用できません。
「googlebq15.pngの説明は以下のとおりです
図googlebq15.pngの説明」

どちらの場合も、プロジェクト名が小文字になるように接続を変更できます。

Oracle Analytics CloudでBigQuery接続をトラブルシューティングする場合、サード・パーティのJDBCクライアントを使用して、同じサービス・アカウント・キーを使用してBigQueryへの接続を試みます。

まだ接続に失敗する場合は、サービス・アカウント・キーに問題があります。

接続に成功する場合は、Oracle Analyticsに問題があるため、Oracleサポートに連絡する必要があります。

このテストは、サービス・アカウント・キーがODBCを通じて検証されない場合に役立ちます。