Linux 上でEnterpriseDB にデータ連携するシンプルなGo アプリケーションを作成

詳細情報をご希望ですか?

無償トライアル:

ダウンロードへ

製品の詳細情報へ:

EnterpriseDB ODBC Driver

EnterpriseDB ODBC Driver は、ODBC 接続をサポートする任意のアプリケーションからリアルタイムなEnterpriseDB のデータに直接接続できる高機能なツールです。

標準のODBC Driver インターフェースを使用して、EnterpriseDB にアクセスします。



CData ODBC Driver for EnterpriseDB とunixODBC を使って、EnterpriseDB に連携するGo アプリケーションを作成。

Go はオープンソースのプログラミング言語でLInux/Unix マシンに簡単にソフトウェアを構築することを可能にします。 Go とODBC Driver for EnterpriseDB およびunixODBC を組み合わせて使うことで、EnterpriseDB データにリアルタイム連携するアプリケーションを書くことができます。 本記事では、ODBC Driver for EnterpriseDB のインストール、unixODBC Driver Manager への設定、そしてEnterpriseDB に連携する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 EnterpriseDB ...

定義されたData Source の表示

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

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

cdata.odbc.enterprisedb.ini

... [Driver] DriverManagerEncoding = UTF-16

DSN の変更

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

データに接続するには、以下の接続プロパティが必要です。

  • Server: EnterpriseDB データベースをホスティングしているサーバーのホスト名またはIP アドレス。
  • Port: EnterpriseDB データベースをホスティングしているサーバーのポート。

オプションで、以下を設定することもできます。

  • Database: EnterpriseDB サーバーに接続する場合のデフォルトのデータベース。設定されていない場合は、ユーザーのデフォルトデータベースが使用されます。

Basic 認証による接続

Basic 認証を使って認証するには、以下を設定します。

  • User:EnterpriseDB サーバーに認証する際に使われるユーザー。
  • Password:EnterpriseDB サーバーに認証する際に使われるパスワード。

SSL 認証による接続

SSL 認証を利用して、セキュアなセッションを介してEnterpriseDB データに接続できます。以下の接続プロパティを設定して、データに接続します。

  • SSLClientCert:クライアント証明書のための証明書ストア名に設定します。クライアントとサーバーの両方のマシンでトラストストアとキーストアが保持される2-way SSL の場合に使用されます。
  • SSLClientCertPassword:クライアント証明書ストアがパスワードで保護されている場合、この値をストアのパスワードに設定します。
  • SSLClientCertSubject:TLS/SSL クライアント証明書のSubject。ストア内の証明書を検索するために使用されます。
  • SSLClientCertType:クライアントストアの証明書タイプ。
  • SSLServerCert:サーバーが受け入れ可能な証明書。

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

[CData EnterpriseDB Source] Driver = CData ODBC Driver for EnterpriseDB Description = My Description User = postgres Password = admin Database = postgres Server = 127.0.0.1 Port = 5444

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

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

Driver Manager のインストール、DSN 設定を終えたら、EnterpriseDB 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 アプリケーションサンプル

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

cdata-odbc-enterprisedb.go

package main import ( _ "github.com/alexbrainman/odbc" "database/sql" "log" "fmt" ) func main() { db, err := sql.Open("odbc", "DSN=CData EnterpriseDB Source") if err != nil { log.Fatal(err) } var ( shipname string shipcity string ) rows, err := db.Query("SELECT ShipName, ShipCity FROM Orders WHERE ShipCountry = ?", "USA") if err != nil { log.Fatal(err) } defer rows.Close() for rows.Next() { err := rows.Scan(&shipname, &shipcity) if err != nil { log.Fatal(err) } fmt.Println(shipname, shipcity) } err = rows.Err() if err != nil { log.Fatal(err) } defer db.Close() }

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

$ go build

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

$ ./cdata-odbc-enterprisedb

これでEnterpriseDB と連携するシンプルなGo アプリケーションができました。ここに、より複雑なread/write 機能を使い慣れたSQL 文で足してみてください。