Linux 上でOracle Eloqua Reporting のデータに接続するGo アプリケーションを作成する方法

Go はオープンソースのプログラミング言語で、高速かつ信頼性の高いソフトウェアを低コストで作成できるのが魅力です。Go とODBC Driver for OracleEloquaReporting およびunixODBC を組み合わせて使うことで、Oracle Eloqua Reporting のデータにリアルタイムで 接続するアプリケーションを作成できます。本記事では、ODBC Driver for OracleEloquaReporting のインストール、unixODBC Driver Manager への設定、そしてOracle Eloqua Reporting に連携するGo アプリケーションの作成までを説明します。

CData ODBC ドライバとは？

CData ODBC ドライバは、以下のような特徴を持った製品です。

1. Oracle Eloqua Reporting をはじめとする、CRM、MA、会計ツールなど多様なカテゴリの270種類以上のSaaS / オンプレデータソースに対応
2. Go をはじめとする多様な開発ツールやノーコードアプリ、BI ツールにOracle Eloqua Reporting のデータを連携
3. ノーコードでの手軽な接続設定

CData ODBC ドライバでは、1.データソースとしてOracle Eloqua Reporting の接続を設定、2.Go 側でODBC Driver との接続を設定、という2つのステップだけでデータソースに接続できます。以下に具体的な設定手順を説明します。

Linux マシンで CData ODBC Drivers を使用する

CData ODBC Drivers はUbuntu、Debian、RHEL、CentOS、およびFedora など多くのRed Hat ベースおよびDebian ベースのシステムでサポートされています。 ほかにもいくつかのライブラリやパッケージのインストールが必要ですが、すでにデフォルトでインストールされている場合もあります。詳細はオンラインおよびインストールされるヘルプドキュメントの「はじめに」のセクションを参照してください。

Driver Manager のインストール

ドライバーのインストール前にシステムにDriver Manager が入っているかを確認してください。本記事では無料のオープンソースDriver Manager であるunixODBC を使います

Ubuntu のようなDebian ベースのシステムでは、APT パッケージマネージャからunixODBC をインストールできます：

$ apt-get install unixODBC unixODBC-dev

Red Hat Linux ベースのシステムでは、yum もしくはdnf からunixODBC をインストールできます：

$ yum install unixODBC unixODBC-devel

unixODBC Driver Manager はDriver の情報をodbcinst.ini ファイルから読み、odbc.ini からデータソースの情報を読みます。 次のコマンドをターミナルに入力して、設定ファイルの配置場所を決めることができます：

$ odbcinst -j

コマンドのアウトプットでODBC データソースのコンフィギュレーションファイルと登録されたODBC Drver のロケーションを表示します。 ユーザーデータソースはodbc.ini ホームフォルダが位置するユーザーアカウントのみからアクセス可能です。システムデータソースはすべてのユーザーからアクセスできます。 このコマンドのアウトプット例は以下です：

DRIVERS............: /etc/odbcinst.ini
SYSTEM DATA SOURCES: /etc/odbc.ini
FILE DATA SOURCES..: /etc/ODBCDataSources
USER DATA SOURCES..: /home/myuser/.odbc.ini
SQLULEN Size.......: 8
SQLLEN Size........: 8
SQLSETPOSIROW Size.: 8

ドライバーのインストール

パッケージ形式でドライバーをダウンロードできます。.deb 形式もしくは、.rpm 形式で提供しています。 ファイルをダウンロードしたら、ターミナルからドライバーをインストールします。

ドライバーインストーラーはドライバーをunixODBC に登録し、ODBC 接続をサポートするツールやアプリケーションから利用できるシステムDSN を作成します。T

Ubuntu のようなDebian ベースのシステムでは、sudo で次のコマンドを実行します：

$ dpkg -i /path/to/package.deb

.rpms をサポートするシステムでは、sudo で次のコマンドを実行します：

$ rpm -i /path/to/package.rpm

ドライバーのインストールが終わったら、unixODBC Driver Manager を使って登録されたドライバーを表示し、データソースを定義することができます。

登録されたドライバーの表示

$ odbcinst -q -d
CData ODBC Driver for OracleEloquaReporting
...

定義されたData Source の表示

$ odbcinst -q -s
CData OracleEloquaReporting Source
...

unixODBC でCData ODBC Driver for OracleEloquaReporting を使用するには、ドライバーがUTF-8 を使用するように設定する必要があります。それには、通常はインストールフォルダのlib フォルダ（/opt/cdata/cdata-odbc-driver-for-oracleeloquareporting）に入っているドライバーのINI ファイル（cdata.odbc.oracleeloquareporting.ini）を次のように編集する必要があります：

cdata.odbc.oracleeloquareporting.ini

...

[Driver]
DriverManagerEncoding = UTF-16

DSN の変更

ドライバーがインストールされると、システムDSN が事前定義されます。システムDSN はシステムデータソースファイル（/etc/odbc.ini）を編集して必要な接続プロパティを定義します。 ユーザー単位のDSN を作成することも可能で、その際には$HOME/.odbc.ini へのアクセスと変更は必要ありません

Oracle Eloqua Reporting では、以下の認証方法に対応しています。

• Basic 認証（ユーザーとパスワード）
• OAuth 2.0 コードグラントフロー
• OAuth 2.0 パスワードグラントフロー

Basic 認証（ユーザーとパスワード）

ユーザーとパスワードで認証するには、以下のプロパティを設定します。

• AuthScheme: Basic を指定します。
• Company: Oracle Eloqua Reporting アカウントに関連付けられた会社名を指定します。
• User: ログインアカウント名を指定します。
• Password: ログインパスワードを指定します。

OAuth 認証（コードグラントフロー）

OAuth コードグラントフローで認証するには、AuthScheme を OAuth に設定し、カスタム OAuth アプリケーションを作成します。カスタム OAuth アプリケーションの作成方法については、ヘルプドキュメントをご参照ください。

続いて、以下のプロパティを設定します。

• InitiateOAuth: GETANDREFRESH を指定します。OAuthAccessToken の自動取得と更新に使用します。
• OAuthClientId: アプリケーション登録時に割り当てられたクライアント ID を指定します。
• OAuthClientSecret: アプリケーション登録時に割り当てられたクライアントシークレットを指定します。
• CallbackURL: アプリケーション登録時に定義したリダイレクト URI を指定します。

接続すると、デフォルトブラウザで Oracle Eloqua Reporting の OAuth エンドポイントが開きます。ログインしてアプリケーションに権限を付与してください。アクセストークンの有効期限が切れると、ドライバーが自動的に更新します。

OAuth 認証（パスワードグラントフロー）

OAuth パスワードグラントフローでは、OAuth アプリケーションの資格情報とユーザー資格情報を組み合わせて認証できます。ブラウザでの手動による権限付与は必要ありません。この認証方法を使用するには、OAuth アプリを作成する必要があります（ヘルプドキュメントを参照）。

以下のプロパティを設定します。

• AuthScheme: OAuthPassword を指定します。
• Company: 会社の一意の識別子を指定します。
• User: ログインアカウント名を指定します。
• Password: ログインパスワードを指定します。
• OAuthClientId: カスタム OAuth アプリケーション登録時に割り当てられたクライアント ID を指定します。
• OAuthClientSecret: カスタム OAuth アプリケーション登録時に割り当てられたクライアントシークレットを指定します。

/etc/odbc.ini or $HOME/.odbc.ini

[CData OracleEloquaReporting Source]
Driver = CData ODBC Driver for OracleEloquaReporting
Description = My Description
AuthScheme = Basic
User = user
Password = password
Company = MyCompany

これらのコンフィギュレーションファイルの使い方についての詳細は、インストールされるヘルプドキュメントを参照してください。

Oracle Eloqua Reporting のデータに連携するGo アプリケーションサンプルの作成

Driver Manager のインストール、DSN 設定を終えたら、Oracle Eloqua Reporting のデータ に連携するGo アプリケーションを作成します。 まずはODBC データベース向けのGo ドライバーをインストールします。いくつかのオプションがありますが、本記事ではhttps://github.com/alexbrainman/odbc のODBC ドライバーを使います。

Linux へのODBC のインストール

Go のODBC ドライバーをインストールするには、GOPATH 環境変数を定義する必要があります：

export GOPATH=$HOME/golang/go

GOPATH が定義されたら、ODBC ドライバー向けのGo ドライバーをインストールすることが可能です：

$ go get github.com/alexbrainman/odbc

これでGo アプリケーションを作って実行する準備ができました。

Go アプリケーションサンプル

このサンプルアプリケーションはOracle Eloqua Reporting のデータ に対してシンプルなSQL SELECT クエリを発行し、結果を表示します。$GOPATH/src/cdata-odbc-eloquareporting ディレクトリを作成し、次のソースコードをコピーして新しいGo ファイルを作成します。

cdata-odbc-eloquareporting.go

package main

import (
  _ "github.com/alexbrainman/odbc"
  "database/sql"
  "log"
  "fmt"
)

func main() {
  db, err := sql.Open("odbc",
    "DSN=CData OracleEloquaReporting Source")
  if err != nil {
    log.Fatal(err)
  }

  var (
     string
     string
  )

  rows, err := db.Query("SELECT ,  FROM  WHERE  = ?", "")
  if err != nil {
    log.Fatal(err)
  }
  defer rows.Close()
  for rows.Next() {
    err := rows.Scan(&, &)
    if err != nil {
      log.Fatal(err)
    }
    fmt.Println(, )
  }
  err = rows.Err()
  if err != nil {
    log.Fatal(err)
  }

  defer db.Close()
}

ターミナルでGo アプリケーションディレクトリに移動して、アプリケーションをビルドします。

$ go build

アプリケーションのビルド後、アプリケーションを実行してOracle Eloqua Reporting のデータを表示することができます。

$ ./cdata-odbc-eloquareporting

おわりに

このようにCData ODBC ドライバと併用することで、270を超えるSaaS、NoSQL データをGo から扱うことができます。30日の無償評価版が利用できますので、ぜひ自社で使っているクラウドサービスやNoSQL と合わせて活用してみてください。

日本のユーザー向けにCData ODBC ドライバは、UI の日本語化、ドキュメントの日本語化、日本語でのテクニカルサポートを提供しています。