はじめに
R SDKは、DomoとRとの間で簡単にデータを転送できるRパッケージです。R SDKを使用すれば、DomoとRとの間でDataSetを移動する処理を簡素化することができます。Data CenterでSDKにアクセスすることができます。また、SDKに関する情報もData Centerで参照することができます。 以下のような場合にR SDKを使用することをお勧めします。- データサイエンスチームが多くの変換にRを使用していて、そのデータをDomoに取り込む必要がある場合。
- SQLを使用せずに、さまざまな統計分析やデータ検索を行う必要がある場合。
- すでにRスクリプトを使用してデータ処理を行っている場合。
- SQL以外の機能を使用してデータサイエンスに関する処理(予測、テキスト分析など)を実行する必要がある場合。
- Rapid Appのプロトタイプを必要とする場合、または動的に再現可能なドキュメント/レポートを作成している場合。
必要条件
R SDKのインストールと初期化を行うには、以下に示す2つの情報が必要になります。-
自分のカスタマーインスタンス名。このトピックでは、「
customer」と表記します。ログインURLの「domo.com」の前の部分が、カスタマーインスタンス名になります。たとえば、DomoのログインURLが「https://modocorp.domo.com」の場合、カスタマーインスタンス名は「modocorp」になります。 -
Domoアクセストークン。このトピックでは、「
domo_access_token」と表記します。これは、Domo API を使って Domo インスタンスをアクセスするのに必要です。このトークンは、社内で「管理者」セキュリティ権限を持っているユーザー(あるいは、[全てのカンパニー設定を管理]または[全てのアクセストークンを管理]が有効になっているカスタム権限を持っているユーザー)が生成する必要があります。このトークンを生成するには、アカウントで [管理者]>[セキュリティ]>[アクセストークン] に移動し、画面右上隅の [アクセストークンを生成] をクリックします。注記: R SDKを使用するには、バージョン1.0.0以下のhttrまたはバージョン0.2.0以下のreadrがRインスタンスにインストールされている必要があります。
Rをインストールする
DomoのプライベートGitHubリポジトリからRをインストールすることができます。インストールには、ヘルパーパッケージが必要です。Hadley Wickham氏が作成した「devtools」というライブラリを使用すれば、GitHubから直接Rパッケージをインストールすることができます。注記: Rは、CRAN(Comprehensive R Archive Network)では 公開されていません 。
Devtools パッケージをインストールする
-
以下を実行して devtools をインストールします
-
R SDKをインストールする
- DomoのプライベートGitHubリポジトリから直接Rをインストールするには、以下のコマンドを実行します。
R 環境を初期化する
R SDKのインストールが完了したら、Domoカスタマーインスタンス(https://customer.domo.com
)とDomoアクセストークン(
domo_access_token
)を使用してRインスタンスを初期化する必要があります。
Domo アクセストークンを生成する
Domoアクセストークン(domo_access_token
)を生成するには、「管理者」レベルのユーザー(あるいは、[全てのカンパニー設定を管理]または[全てのアクセストークンを管理]が有効になっているカスタム権限を持っているユーザー)としてDomoインスタンスにログインし、
[管理者]>[セキュリティ]>[アクセストークン]
に移動します。セキュリティロールの詳細については、「
セキュリティ権限リファレンス
」を参照してください。
Rを初期化する
Domo インスタンスでトークンを生成したら、以下のコマンドを使って R 開発環境を初期化します:R::init('customer', 'domo_access_token')
このコマンドの「
customer
」の部分には、Domo URLの「
domo.com
」の前にあるカスタマーインスタンス名を指定し(「
modocorp.domo.com
」というURLの場合は「
modocorp
」の部分がカスタマーインスタンス名になります)、「
domo_access_token
」の部分には、Domoインスタンス内で生成したアクセストークンを指定します。
Rの開発環境の初期化が完了すると、Rで以下の処理を実行できるようになります。
- DataSet をリストする
- DataSet を fetch し、データフレームに変換する
- データフレームをアップロードして DataSet を作成する
- データフレームをアップロードして DataSet を置き換える