ADO.NET Provider for Google Analytics

Build 26.0.9663

高度なクエリ

Google Analytics には非常に多くの指標とディメンションがあり、テーブル定義が複雑になるため、製品に含まれるテーブル定義は最もよく使用される組み合わせのみをリストしています。この設計上の選択に対して 2 つの代替手段を提供しています:デフォルトのテーブルに含まれていないフィールドをリクエストするために Dimensions および Metrics カラムを使用する方法と、独自のテーブルを定義する方法です。

Dimensions および Metrics カラムの使用

既存のテーブルに追加のディメンションや指標をリクエストするには、カスタムスキーマを定義することが推奨されるアプローチです。ただし、WHERE 句で Dimensions および Metrics の入力を設定することもできます。どちらの入力もカンマ区切りのリストを受け付けるため、複数のフィールドを一度に指定できます。値は送信した順序と同じ順序で、対応する Dimensions および Metrics カラムに返されます。例えば、次のクエリは Traffic テーブルに対して Sessions、Goal 1 Conversion Rate、Goal 1 Completions をクエリし、これらの指標を UserAgeBracket ディメンションでグループ化します:

SELECT Sessions, Dimensions, Metrics FROM Traffic WHERE Dimensions='UserAgeBracket' AND Metrics='Goal1ConversionRate,Goal1Completions'
上記のクエリの結果では、UserAgeBracket の値が各行の Dimensions フィールドに返されます。Metrics フィールドには、Goal 1 に関するリクエストされた指標がカンマ区切りの値として含まれます。

カスタムスキーマの定義

本製品 に付属している標準テーブルで利用できないフィールドを定期的にリクエストする必要がある場合は、必要なデータをより簡単にクエリできるように、独自のカスタムスキーマを定義することをお勧めします。CreateCustomSchema ストアドプロシージャを使用して、まったく新しいテーブルを定義したり、必要なカラムを追加するために既存のスキーマを変更したりできます。

ストアドプロシージャはスキーマファイルを出力します。このスキーマファイルは直接編集しやすいシンプルな形式になっています。

CreateCustomSchema ストアドプロシージャの使用

本製品 は新しいテーブル定義を作成するための CreateCustomSchema ストアドプロシージャも提供しています。このストアドプロシージャは、テーブル名、カンマ区切りの指標リスト、カンマ区切りのディメンションリスト、および出力フォルダを入力として受け取ります。このプロシージャを呼び出すと、新しいスキーマファイルが作成され、他のクエリ可能なテーブルと同様にコンテンツが公開されます。

Location 接続プロパティに任意のパスを設定してください。Location 内に(このプロシージャの実行元スキーマの名前を持つ)フォルダが存在しない場合は作成されます。スキーマファイルはそのサブフォルダに配置されます。上記のサブフォルダが既に Location 内に存在する場合は、スキーマファイルはそこに配置されます。

以下のストアドプロシージャの呼び出し例は、「Dimensions および Metrics カラムの使用」の SELECT クエリのカラムを保存します:

EXEC CreateCustomSchema TableName='Traffic', Dimensions='UserAgeBracket', Metrics='Sessions,Goal1ConversionRate,Goal1Completions',OutputFolder='C:\Users\Administrator\Desktop'

既存スキーマの手動編集

既存のスキーマにフィールドを追加するには、本製品 のインストールディレクトリにある対応する .rsd ファイルを開き、以下の手順に従ってください:

  1. カラムを追加するために、<rsb:info> セクションに attr タグを追加します。
  2. 以下の属性を追加します。既存のフィールドはいずれも参考例として使用できます。

    属性名属性値
    nameAPI ドキュメント で定義されているディメンションまたは指標に設定します。
    xs:typeデータ型に設定します。
    other:dimensionディメンションのカラムを定義する場合は "true" に設定します。
    other:metric指標のカラムを定義する場合は "true" に設定します。

  3. 新しいファイルを使用するには、Location 接続プロパティをスクリプトファイルが含まれるフォルダに設定します。

Copyright (c) 2026 CData Software, Inc. - All rights reserved.
Build 26.0.9663