SQL Workbench/Jへの接続

SQL Workbench/Jは、PostgreSQLやMySQLなどの多くのデータベース管理システム（DBMS）に接続できるシンプルで使いやすい無料のクエリツールです。SQL Workbench/Jを使用してデータベースに簡単に接続し、データベーススキーマを表示し、データを分析します。

インストールと構成

ダウンロードとインストール

以下の手順では、SQL WorkbenchとAmazon Redshift JDBCドライバのダウンロード方法について説明します：

1. SQL Workbenchをダウンロードしてインストールします。
2. Amazon Redshift JDBCドライバをダウンロードしてインストールします。
3. .jarファイルをコンピュータの安全な場所に保存します。 このファイルを削除すると、接続が切断されます。

ドライバのビルド

Amazon Redshift JDBCのドライバは、データベースに接続する前にSQL Workbenchにインストールする必要があります。 以下の手順では、Amazon Redshift JDBCドライバのインストール方法について説明します：

1. SQL Workbench/Jを開きます。
2. 画面の左下にあるドライバの管理をクリックします。
3. 新しいエントリを作成アイコンをクリックします。
   

   

4. 名前フィールドにRedshiftと入力します。
5. ライブラリテキストエリアの右側にあるフォルダアイコンをクリックします。
   

   

6. ドライバの場所に移動し、それをクリックして選択し、開くをクリックします。
   クラス名フィールドは、41がドライババージョンを示すcom.amazon.redshift.jdbc_41_.Driverに構成されます。
7. OKをクリックして終了します。
   これで、Redshiftデータベースが構成されました。

接続プロファイルの作成

以下の手順では、SQL Workbenchに接続資格情報を提供して接続プロファイルを作成する方法について説明します：

1. SQL Workbench/Jインターフェースで、新しい接続プロファイルを作成アイコンをクリックします。
   

   

2. 新しいプロファイルに名前を付けます。例えば、Tealiumアカウントとプロファイルを組み合わせた名前、mycompany-mainなど。
3. ドライバドロップダウンリストからAmazon Redshift JDBC Driver (com.amazon.redshift.jdbc41.Driver)を選択します。
   

   

4. Tealiumアカウントで、Store > EventDBまたはStore > AudienceDBに移動します。
5. DB接続詳細を取得をクリックします。
   DB接続詳細ダイアログが表示されます。このウィンドウを開いたまま進行します。以下の例では、機密性を保つために資格情報が削除されています。
   

   

6. SQL Workbenchに戻り、DataAccessからの接続値でHOST、PORT、DATABASEを置き換えた以下の例に基づいたURLを入力します：jdbc:redshift://HOST:PORT/DATABASE?ssl=true。
   

   

7. 資格情報を使用してユーザ名とパスワードを入力します。
8. Autocommitチェックボックスをチェックします。
   

   

9. プロファイルリストを保存アイコンをクリックして保存します。
   

   

10. OKをクリックして接続を試みます。

成功すると、ステートメントページが表示されます。ここから、データをクエリするスクリプトの作成を開始できます。

EventDBまたはAudienceDBを最近有効にした場合、データが利用可能になるまでに最大1時間かかる場合があります。

トラブルシューティング

以下のセクションでは、一般的なエラーとトラブルシューティングのヒントについて情報を提供します。

一般的なエラー

• Redshift JARファイルの削除
  Redshift JARファイルが削除されると、接続が切断されます。ホームフォルダなど、安全な場所に保存しておくようにしてください。
• ユーザ名とデータベース名の混同
  • ユーザ名にはaccount_profileが含まれています。
  • データベースはTealiumアカウント名です。
• Autocommitチェックボックスをチェックしない
  保存する前にAutocommitチェックボックスをチェックしないと、接続インスタンスごとに1つのクエリしか行えません。

ヒント

• パスワードの表示
  パスワードを表示する必要がある場合は、SQLWorkbench/Jのパスワード入力フィールドの隣にあるパスワードを表示をクリックします。
  

  

• EventDBのイベントフィードを有効にする
  EventDBでは、EventDBに送信するイベントフィードを有効にする必要があります。詳細については、イベントフィードを参照してください。
• AudienceDBの属性を有効にする
  AudienceDBでは、AudienceDBに送信する属性を有効にする必要があります。詳細については、AudienceDBへの属性の追加を参照してください。
  • 上記の手順を完了しないと、基本的な訪問レベルのデータとオーディエンスのみを含む多くのvisit_とvisitor_テーブルとビューが表示されます。属性データは含まれません。
  • AudienceDBには250属性のソフトリミットがあります。この数に達すると、パフォーマンスが低下する可能性があります。

SQL Workbenchの使用

SQL Workbench/Jの接続プロファイルを作成したら、データのクエリを開始する準備が整いました。このドキュメントに従って開始します。まず、データ列名とテーブルとリストスキーマが何を表しているかを学びます。

接続とデータスキーマサポートに関する追加の質問がある場合は、Tealiumアカウントマネージャーに連絡してください。クエリサポート、データエクスポート、ビジネスインテリジェンス（BI）ツールへの統合に関する追加のヘルプが必要な場合は、データサイエンティストやデータベース管理者などのチームメンバーに連絡してください。

以下のセクションでは、SQL Workbench/Jインターフェースで最もよく使用される画面についての一般的な情報を提供します。

ステートメント

SQL Workbench/Jインターフェースから、ステートメントタブをクリックしてSQLステートメントを作成し、結果やエラーメッセージを表示します。

データベースエクスプローラ

SQL Workbench/Jインターフェースから、データベースエクスプローラに移動して利用可能なデータを確認します。

左パネルには、Redshiftインスタンス内でアクセス可能なテーブルとビューが表示されます。各テーブルやビューには異なるデータが含まれています。クエリを正しく構築するためには、クエリ可能な列名、例えばudo_job_roleなどを知る必要があります。右パネルは、データ列名をナビゲートし、クエリを構築するのに役立ちます。

• テーブル
  テーブルは、データベースでデータを格納するための標準的な方法です。テーブルの数は、EventDBとAudienceDBで有効にしたフィルタリングされたストリームの数によります。
• ビュー
  各テーブルには対応するビューがあります。ビューは、テーブル列のより人間が読みやすいバージョンを提供します。
• 例
  • テーブルはtags_main_1_executedを表示しますが、ビューはevent - tags - tealium collect (main 1) - executedを表示します。
  • テーブルはudo_job_roleを表示しますが、ビューはevent - udo - job_roleを表示します。
• EventDBでの使用
  • events__all_eventsテーブルは、デフォルトですべてのイベントを保持します。
  • それぞれのフィルタリングされたストリームにはテーブルがあります。例えばevents__f84fc357_4ded_413d_d28a_de70624ff2d5など。
• AudienceDBでの使用
  • visit_listsには、クエリのための現在の訪問スコープのリスト属性が含まれています。
• visit_talliesは、クエリのための現在の訪問範囲の集計属性を含みます。
  • visitor_listsは、クエリのための訪問範囲のリスト属性を含みます。
  • visitor_talliesは、クエリのための訪問範囲の集計属性を含みます。
  • visitor_replacesは、ステッチされた訪問プロファイルを含みます。
  • visitorsは最も一般的に使用されるテーブルで、各訪問と彼らが所属する任意のオーディエンスの最新の訪問範囲のデータを含みます。
  • visitsは、各訪問の最新の訪問範囲のデータを含みます。
• 制限事項
  • ファネルとタイムラインの属性はサポートされていません。

列名の表示

オブジェクトタブをクリックして、各テーブルまたはビューの列名を表示します。インターフェースの利用可能なフィルタを使用して結果を微調整できます。デフォルトでは、COLUMN_NAMEはアルファベット順ではありません。ヘッダー行をクリックして名前をアルファベット順に並べ替えます。

ランダムなサンプルデータの表示

テーブルデータの検索タブをクリックして、ランダムなデータのサンプルを表示します。インターフェースの利用可能なフィルタを使用して結果を微調整できます。

避けるべき一般的なエラー

以下の項目は、避けるべき一般的なエラーとして注意されています：

• iQタグ管理（TiQ）データレイヤー内のutag_dataでUDO変数を宣言しないこと。変数が宣言されていない場合、それらはEventDBに表示されません。
• AudienceStream属性をAudienceDBに送信するように構成しないこと。各属性は手動で選択する必要があります。属性のソフトリミットは250です。もしもっと多くの列が必要な場合は、Tealiumのアカウントマネージャーに連絡してください。