CData ODBC Driver for MYOB AccountRight とunixODBC を使って、MYOB AccountRight に連携するGo アプリケーションを作成。
Go はオープンソースのプログラミング言語でLInux/Unix マシンに簡単にソフトウェアを構築することを可能にします。 Go とODBC Driver for MYOB AccountRight およびunixODBC を組み合わせて使うことで、MYOB AccountRight データにリアルタイム連携するアプリケーションを書くことができます。 本記事では、ODBC Driver for MYOB AccountRight のインストール、unixODBC Driver Manager への設定、そしてMYOB AccountRight に連携するGo アプリケーションの作成までを説明します。
Linux マシンで CData ODBC Drivers を使用する
CData ODBC Drivers はUbuntu、Debian、RHEL、CentOS、およびFedora など多くのRed Hat-based およびDebian-based のシステムでサポートされています。 ほかにもいくつかのライブラリやパッケージのインストールが必要ですが、すでにデフォルトでインストールされている場合もあります。詳細はオンラインおよびインストールされるヘルプドキュメントの「はじめに」のセクションを参照してください。
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
ドライバーのインストール
標準パッケージ形式でドライバーをダウンロードできます:Debian .deb package format もしくは、.rpm file format です。 ファイルをダウンロードしたら、ターミナルからドライバーをインストールします。
ドライバーインストーラーはドライバーを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 MYOB AccountRight
...
定義されたData Source の表示
$ odbcinst -q -s
CData MYOB Source
...
unixODBC でCData ODBC Driver for MYOB AccountRight を使用するには、ドライバーがUTF-8 を使用するように設定する必要があります。それには、通常はインストールフォルダのlib フォルダ(/opt/cdata/cdata-odbc-driver-for-myob)に入っているドライバーのINI ファイル(cdata.odbc.myob.ini)を次のように編集する必要があります:
cdata.odbc.myob.ini
...
[Driver]
DriverManagerEncoding = UTF-16
DSN の変更
ドライバーがインストールされると、システムDSN が事前定義されます。システムDSN はシステムデータソースファイル(/etc/odbc.ini)を編集して必要な接続プロパティを定義します。 ユーザー単位のDSN を作成することも可能で、その際には$HOME/.odbc.ini へのアクセスと変更は必要ではありません。
これらのプロパティは会社のファイルに接続するときに必要です(クラウドインスタンスおよびオンプレミスインスタンスの両方)。
- User:会社のファイルに紐づいているユーザー名。
- Password:会社のファイルに紐づいているパスワード。
- CompanyFileId:会社ファイルのID。指定しない場合は、最初に返された会社ファイルのID が使用されます。CompanyFiles ビュー をクエリしてこれを見ることができます:
SELECT Id FROM CompanyFiles
オンプレミスインスタンスへの接続:
InitiateOAuth:OFF に設定。オンプレミスインスタンスに接続する場合は、上記に加えて、次の接続プロパティを設定する必要があります。
- Url: MYOB インスタンスのURL。
クラウドインスタンスへの接続:
MYOB のクラウドインスタンスに接続するには、OAuth アプリを作成する必要があります。このプロセスの詳細は、カスタムOAuth アプリの作成 にあります。
/etc/odbc.ini or $HOME/.odbc.ini
[CData MYOB Source]
Driver = CData ODBC Driver for MYOB AccountRight
Description = My Description
OAuthClientId = YourClientId
OAuthClientSecret = YourClientSecret
CompanyFileId = yourCompanyFileId
CallbackURL = http://localhost:33333
User = companyFileUser
Password = companyFilePassword
これらのコンフィギュレーションファイルの使い方についての詳細は、インストールされるヘルプドキュメントを参照してください。
MYOB AccountRight データに連携するGo アプリケーションサンプルの作成
Driver Manager のインストール、DSN 設定を終えたら、MYOB AccountRight data に連携する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 アプリケーションサンプル
このサンプルアプリケーションはMYOB AccountRight data に対してシンプルなSQL SELECT クエリを発行し、結果を表示します。$GOPATH/src/cdata-odbc-myobaccountright ディレクトリを作成し、次のソースコードをコピーして新しいGo ファイルを作成します。
cdata-odbc-myobaccountright.go
package main
import (
_ "github.com/alexbrainman/odbc"
"database/sql"
"log"
"fmt"
)
func main() {
db, err := sql.Open("odbc",
"DSN=CData MYOB Source")
if err != nil {
log.Fatal(err)
}
var (
id string
name string
)
rows, err := db.Query("SELECT Id, Name FROM Accounts WHERE Type = ?", "Bank")
if err != nil {
log.Fatal(err)
}
defer rows.Close()
for rows.Next() {
err := rows.Scan(&id, &name)
if err != nil {
log.Fatal(err)
}
fmt.Println(id, name)
}
err = rows.Err()
if err != nil {
log.Fatal(err)
}
defer db.Close()
}
ターミナルで、Go アプリケーションディレクトリにナビゲートし、アプリケーションをビルドします:
$ go build
アプリケーションのビルド後、アプリケーションを実行し、MYOB AccountRight のデータを表示することができます:
$ ./cdata-odbc-myobaccountright
これでMYOB AccountRight と連携するシンプルなGo アプリケーションができました。ここに、より複雑なread/write 機能を使い慣れたSQL 文で足してみてください。