ODBC 経由で R から Alchemy のデータ を分析

Jerod Johnson
Jerod Johnson
Director, Technology Evangelism
Microsoft R Open で Alchemy のデータ のデータビジュアライゼーションを作成し、高性能な統計関数で分析。

純粋な R スクリプトと標準 SQL で Alchemy のデータ にアクセスできます。CData ODBC ドライバ for Alchemy と RODBC パッケージを使用すると、R からリモート Alchemy のデータ を操作できます。CData ドライバを使用することで、業界で実績のある標準に準拠したドライバを活用し、人気のオープンソース言語 R でデータにアクセスできます。この記事では、ドライバを使用して Alchemy のデータ に SQL クエリを実行し、R で Alchemy のデータ を可視化する方法を説明します。

R をインストール

マルチスレッドや管理コードによるドライバのパフォーマンス向上は、マルチスレッド対応の Microsoft R Open や、BLAS/LAPACK ライブラリにリンクした R を実行することで補完できます。この記事では Microsoft R Open（MRO）を使用します。

Alchemy にODBC データソースとして接続

Alchemy への接続情報と、Windows および Linux 環境での DSN 設定手順を説明します。

まず、Profile 接続プロパティをディスク上の Alchemy プロファイルの場所に設定します（例：C:\profiles\Alchemy.apip）。次に、ProfileSettings 接続プロパティを Alchemy の接続文字列に設定します（以下を参照）。

Alchemy API プロファイル設定

Alchemy では API キー認証を使用します。API キーはリクエスト URL のパスに含めて送信されます。API キーは以下の手順で取得できます。

  1. https://dashboard.alchemy.com で Alchemy アカウントにサインインします。
  2. 既存のアプリを開くか、新しいアプリを作成します。
  3. 「API Key」ダイアログから、アプリの API キーをコピーします。

API キーを取得したら、以下の接続プロパティを設定します。

  • AuthScheme：APIKey に設定します。
  • Network：（オプション）NFT API リクエストの対象となるブロックチェーンネットワークのスラッグです（例：eth-mainnet、base-mainnet、polygon-mainnet）。デフォルトは eth-mainnet です。

ProfileSettings 接続プロパティには、以下を設定します。

  • APIKey：Alchemy アプリの API キーに設定します。

DSN を設定する際に、Max Rows 接続プロパティも設定することをお勧めします。これにより返される行数が制限され、レポートやビジュアライゼーションの設計時のパフォーマンス向上に役立ちます。

Windows

まだ設定していない場合は、ODBC DSN（データソース名）で接続プロパティを指定します。これはドライバーインストールの最後のステップです。Microsoft ODBC データソースアドミニストレーターを使用して、ODBC DSN を作成・設定できます。

Linux

Linux 環境で CData ODBC Driver for Alchemy をインストールする場合、ドライバーのインストール時にシステム DSN が事前定義されます。システムデータソースファイル（/etc/odbc.ini）を編集して、必要な接続プロパティを定義することで DSN を変更できます。

/etc/odbc.ini


[CData API Source]
Driver = CData ODBC Driver for Alchemy
Description = My Description
Profile = C:\profiles\Alchemy.apip
AuthScheme = APIKey
Network = eth-mainnet
ProfileSettings = 'APIKey = your_api_key'

これらの設定ファイルの使用方法の詳細については、ヘルプドキュメント（インストール済みまたはオンライン）を参照してください。

RODBC パッケージを読み込む

ドライバを使用するには、RODBC パッケージをダウンロードします。RStudio で、［ツール］ -> ［パッケージのインストール］をクリックし、［パッケージ］ボックスに RODBC と入力します。

RODBC パッケージをインストールした後、以下の行でパッケージを読み込みます。 


library(RODBC)

注意：この記事では RODBC バージョン 1.3-12 を使用しています。Microsoft R Open を使用すると、Microsoft の MRAN リポジトリのチェックポイント機能を使用して同じバージョンでテストできます。 checkpoint コマンドを使用すると、MRAN リポジトリでホストされている CRAN リポジトリのスナップショットからパッケージをインストールできます。2016年1月1日のスナップショットにはバージョン 1.3-12 が含まれています。 


library(checkpoint)
checkpoint("2016-01-01")

Alchemy のデータ にODBC データソースとして接続

以下の行で R から DSN に接続できます。 


conn <- odbcConnect("CData API Source")

スキーマの検出

ドライバは Alchemy API をリレーショナルテーブル、ビュー、ストアドプロシージャとしてモデル化します。以下の行でテーブルの一覧を取得できます。 


sqlTables(conn)

SQL クエリを実行

sqlQuery 関数を使用して、Alchemy API でサポートされている任意の SQL クエリを実行できます。 


contractsforowner <- sqlQuery(conn, "SELECT Address, Name FROM ContractsForOwner WHERE Owner = '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'", believeNRows=FALSE, rows_at_time=1)

以下のコマンドでデータビューアウィンドウに結果を表示できます。 


View(contractsforowner)

Alchemy のデータ をプロット

これで、CRAN リポジトリで利用可能なデータビジュアライゼーションパッケージを使用して Alchemy のデータ を分析できます。組み込みのバープロット関数を使用して、シンプルな棒グラフを作成できます。 


par(las=2,ps=10,mar=c(5,15,4,2))
barplot(contractsforowner$Name, main="Alchemy ContractsForOwner", names.arg = contractsforowner$Address, horiz=TRUE)
基本的な棒グラフ（Salesforce の例）

はじめる準備はできましたか？

API Driver で Alchemy のライブデータに接続

Alchemy に接続

この記事の内容

関連記事