> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# R SDKをインストールする

## はじめに

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のインストールから初期化にいたるまでのプロセスについて説明します。

さらに詳しい説明については、 [https://github.com/domoinc/rdomo](https://github.com/domoinc/rdomo "https://github.com/domoinc/rdomo") を参照してください。

**ビデオ - Domo Rプラグインの概要**

![]()

<iframe allowfullscreen="" frameborder="0" height="315" src="//www.youtube-nocookie.com/embed/sKmD12dKSBI" width="560" />

## 必要条件

R SDKのインストールと初期化を行うには、以下に示す2つの情報が必要になります。

* 自分のカスタマーインスタンス名。このトピックでは、「 `customer` 」と表記します。ログインURLの「 `domo.com` 」の前の部分が、カスタマーインスタンス名になります。たとえば、DomoのログインURLが「 `https://modocorp.domo.com` 」の場合、カスタマーインスタンス名は「 `modocorp` 」になります。
* Domoアクセストークン。このトピックでは、「 `domo_access_token` 」と表記します。これは、Domo API を使って Domo インスタンスをアクセスするのに必要です。このトークンは、社内で「管理者」セキュリティ権限を持っているユーザー（あるいは、［全てのカンパニー設定を管理］または［全てのアクセストークンを管理］が有効になっているカスタム権限を持っているユーザー）が生成する必要があります。このトークンを生成するには、アカウントで **［管理者］>［セキュリティ］>［アクセストークン］** に移動し、画面右上隅の **［アクセストークンを生成］** をクリックします。

  <Note>
    **注記：** R SDKを使用するには、バージョン1.0.0以下のhttrまたはバージョン0.2.0以下のreadrがRインスタンスにインストールされている必要があります。
  </Note>

## Rをインストールする

DomoのプライベートGitHubリポジトリからRをインストールすることができます。インストールには、ヘルパーパッケージが必要です。Hadley Wickham氏が作成した「devtools」というライブラリを使用すれば、GitHubから直接Rパッケージをインストールすることができます。

<Note>
  **注記：** Rは、CRAN（Comprehensive R Archive Network）では *公開されていません* 。
</Note>

### Devtools パッケージをインストールする

* 以下を実行して devtools をインストールします

  * ```install.packages("devtools") theme={"dark"}

      library("devtools")

    install_github(repo="domoinc-r/R")
    ```

### R SDKをインストールする

* DomoのプライベートGitHubリポジトリから直接Rをインストールするには、以下のコマンドを実行します。

## R 環境を初期化する

R SDKのインストールが完了したら、Domoカスタマーインスタンス（
`https://customer.domo.com`
）とDomoアクセストークン（
`domo_access_token`
）を使用してRインスタンスを初期化する必要があります。

### Domo アクセストークンを生成する

Domoアクセストークン（
`domo_access_token`
）を生成するには、「管理者」レベルのユーザー（あるいは、［全てのカンパニー設定を管理］または［全てのアクセストークンを管理］が有効になっているカスタム権限を持っているユーザー）としてDomoインスタンスにログインし、
**［管理者］>［セキュリティ］>［アクセストークン］**
に移動します。セキュリティロールの詳細については、「
[セキュリティ権限リファレンス](/s/article/360043438953 "セキュリティ権限リファレンス")
」を参照してください。

### Rを初期化する

Domo インスタンスでトークンを生成したら、以下のコマンドを使って R 開発環境を初期化します：

`R::init('customer', 'domo_access_token')`

このコマンドの「
`customer`
」の部分には、Domo URLの「
`domo.com`
」の前にあるカスタマーインスタンス名を指定し（「
[modocorp.domo.com](http://modocorp.domo.com)
」というURLの場合は「
`modocorp`
」の部分がカスタマーインスタンス名になります）、「
`domo_access_token`
」の部分には、Domoインスタンス内で生成したアクセストークンを指定します。

Rの開発環境の初期化が完了すると、Rで以下の処理を実行できるようになります。

* DataSet をリストする
* DataSet を fetch し、データフレームに変換する
* データフレームをアップロードして DataSet を作成する
* データフレームをアップロードして DataSet を置き換える

日本語