Remote Oracle Database としてSnowflake のデータにアクセス

こんにちは！ドライバー周りのヘルプドキュメントを担当している古川です。

CData ODBC Driver for Snowflake を使って、ODBC 標準をサポートするあらゆるアプリケーションからデータに連携できます。Oracle Database Gateway for ODBC は、ODBC データソースにリモートOracle データベースとして連携接続できるようにするHeterogeneous Services agent （異種サービスエージェント）です。この記事では、CData ODBC Driver for Snowflake を使ってSnowflake からOracle にデータベースリンクを作成する方法、およびSQL*Plus ツールを介してSnowflake に連携してクエリする方法について説明します。SQL Developer からも、データベースリンクの作成およびクエリの実行ができます。

CData ODBC ドライバとは？

CData ODBC ドライバは、以下のような特徴を持ったリアルタイムデータ連携ソリューションです。

1. Snowflake をはじめとする、CRM、MA、会計ツールなど多様なカテゴリの270種類以上のSaaS / オンプレミスデータソースに対応
2. 多様なアプリケーション、ツールにSnowflake のデータを連携
3. ノーコードでの手軽な接続設定
4. 標準 SQL での柔軟なデータ読み込み・書き込み

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

CData ODBC ドライバのインストールとSnowflake への接続設定

まずは、本記事右側のサイドバーからSnowflake ODBC Driver の無償トライアルをダウンロード・インストールしてください。30日間無償で、製品版の全機能が使用できます。

Oracle ODBC Gateway 互換性のための接続プロパティ

ドライバーには複数の接続プロパティがあり、Oracle データベースと同じようにSnowflake にアクセスできます。SQL*Plus およびSQL Developer のSnowflake を扱う場合は、以下のプロパティを設定します。Oracle ODBC Gateway との互換性のため、認証およびその他の必要な接続プロパティに加えて、以下の接続プロパティを設定する必要があります。

• MapToWVarchar=False

  このプロパティをSQL_WVARCHAR の代わりにSQL_VARCHAR に設定して文字列データ型をマップします。さまざまなインターナショナルキャラクタセットに対応するため、ドライバーはデフォルトでSQL_WVARCHAR を使います。unicode タイプが返されたときに、このプロパティを使ってORA-28528 Heterogeneous Services データタイプ変換エラーを防ぐことができます。

• MaximumColumnSize=4000

  このプロパティを設定して、カラムの最大サイズを4000文字に制限します。Oracle Database Gateway では、文字列型はカラムの最大サイズが4000である必要があります。

• UpperCaseIdentifiers=True

  このプロパティで、識別子を引用しないようにし設定します。このプロパティを使って、大文字の識別子をOracle にレポートします。Oracle はデフォルトで識別子を大文字で格納するため、大文字の識別子を引用から避ける必要はありません。

• IncludeDualTable=True

  このプロパティを設定して、Oracle DUAL 表をモックします。SQL Developer はこのテーブルを使って接続をテストします。

Heterogeneous Service Agent の初期化

下記の手順に従ってODBC Gateway をSnowflake のデータ に作成すると、リアルタイムSnowflake にOracle データベースとしてクエリすることが可能になります。

1. 接続プロパティの指定がまだの場合は、DSN （データソース名）で行います。Microsoft ODBC データソースアドミニストレーターを使ってODBC DSN を作成および設定できます。

   Snowflake データベースに接続するには、認証に加えて次のプロパティを設定します。

   • Url：自身のSnowflake URL、例えばhttps://orgname-myaccount.snowflakecomputing.com。
     • Legacy URL を使用する場合：https://myaccount.region.snowflakecomputing.com
     • 自身のURL を見つけるには：
       1. Snowflake UI の左下にある自身の名前をクリックします。
       2. Account ID にカーソルを合わせます。
       3. Copy Account URL アイコンをクリックして、アカウントURL をコピーします。
   • Database（オプション）：によって公開されるテーブルとビューを、特定のSnowflake データベースのものに制限します。
   • Schema（オプション）：本製品によって公開されるテーブルとビューを、特定のSnowflake データベーススキーマのものに制限します。

   Snowflake への認証

   本製品は、Snowflake ユーザー認証、フェデレーション認証、およびSSL クライアント認証をサポートしています。認証するには、User とPassword を設定し、AuthScheme プロパティで認証メソッドを選択します。

   キーペア

   ユーザーアカウントに定義されたプライベートキーを使用してセキュアなトークンを作成することにより、キーペア認証を使用して認証できます。この方法で接続するには、AuthScheme をPRIVATEKEY に設定し、次の値を設定します。

   • User：認証に使用するユーザーアカウント。
   • PrivateKey：プライベートキーを含む.pem ファイルへのパスなど、ユーザーに使用されるプライベートキー。
   • PrivateKeyType：プライベートキーを含むキーストアの種類（PEMKEY_FILE、PFXFILE など）。
   • PrivateKeyPassword：指定されたプライベートキーのパスワード。

   その他の認証方法は、ヘルプドキュメントの「Snowflake への認証」セクションを参照してください。

   Microsoft ODBC データソースアドミニストレーターで必要なプロパティを設定する方法は、ヘルプドキュメントの「はじめに」をご参照ください。

2. oracle-home-directory\hs\admin フォルダにinitmysnowflakedb.ora ファイルを作成し、以下の設定を追加します：

   HS_FDS_CONNECT_INFO = "Your-Snowflake-DSN"

3. oracle-home-directory\NETWORK\admin にあるlistener.ora ファイルに、次のアドレスを追加します:

   SID_LIST_LISTENER = (SID_LIST = (SID_DESC = (SID_NAME = mysnowflakedb) (ORACLE_HOME = your-oracle-home) (PROGRAM = dg4odbc) ) )

4. oracle-home-directory\NETWORK\admin にあるtnsnames.ora ファイルに、次の接続ディスクリプタを追加します:

   mysnowflakedb = (DESCRIPTION= (ADDRESS=(PROTOCOL=tcp)(HOST=localhost)(PORT=1521)) (CONNECT_DATA=(SID=mysnowflakedb)) (HS=OK) )

5. 次のコマンドを使って設定をテストします：

   tnsping mysnowflakedb

6. SQL*Plus を起動し、次のコマンドでデータベースリンクを作成します：

   CREATE DATABASE LINK MYSNOWFLAKEDB CONNECT TO "user" IDENTIFIED BY "password" USING 'mysnowflakedb';

これで、SQL*Plus で次のようなクエリを実行できます：

Snowflake からOracle Database へのデータ連携には、ぜひCData ODBC ドライバをご利用ください

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

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