Skip to main content

OpenRefine のインストール

System requirements​

OpenRefine は基本機能においてインターネット接続を必要としません。一度ダウンロードしてローカルにインストールすると、小さなウェブサーバーとして動作し、ブラウザからそのローカルサーバーへアクセスする形になります。インターネット接続は、Web からデータを読み込む、リコンシリエーションサービスを使う、あるいは Web にエクスポートする場合だけに必要です。

OpenRefine を動作させるには次の3つが必要です。

対応 OS​

OpenRefine は Windows、Mac、Linux 向けに設計されています。各 OS 向けのパッケージを提供しています。

Java​

OpenRefine を動かすには Java がインストールされている必要があります。Mac 版には Java を同梱しており、OpenRefine 3.4 以降では Java 同梱の Windows パッケージも用意されています。

Java をご自身でインストールしたい場合は、Adoptium.net から事前ビルド済みの Java Runtime Environment (JRE) を取得できます。OpenRefine 3.7 では Java 11～17 をサポートしています。

Java を持たずに Windows で OpenRefine を起動すると、このページが自動的にブラウザに表示されます。

対応ブラウザ​

OpenRefine は WebKit ベースのブラウザで最適に動作します。たとえば:

Firefox などでは軽微なレンダリングやパフォーマンスの差が報告されています。Internet Explorer はサポート対象外です。問題がある場合は Running セクションのトラブルシューティング をご覧ください。

リリースバージョン​

OpenRefine には常に 最新版の安定リリース があり、さらに beta・release candidate・スナップショット などの先行版も用意されています。はじめてインストールする場合は 最新版の安定リリース をおすすめします。

旧バージョン専用の拡張機能など最新機能が不要な場合は、古い安定版リリース を選んでも構いません。後続のリリースでどの脆弱性が修正されているかをチェックし、リスク許容度を踏まえて選んでください。"beta" や "release candidate" ではなく "final release" 表記を優先してください。

不安定なバージョン​

新しい機能を今すぐ使いたい、かつ多少の未検証コードに耐えられる場合は、最新のリリース一覧 を参照して変更点を確認できます。

“Beta” や “release candidate” には未報告のバグが含まれがちで、積極的にバグ報告を行ってくださる方（issue を作成する など）が向いています。

さらに進んだ開発版の更新を追いたい場合は、snapshot リリース をご覧ください。各コミットごとに作成されます。

インストールまたはアップグレード​

データをバックアップする​

古いバージョンからアップグレードする場合、既存のプロジェクトを新バージョン導入前にバックアップしてください。

まず ワークスペースディレクトリを見つけ、そこにあるすべてのファイルをコピーして別のフォルダに保存します。

さらに安全性を高めたい場合は、既存プロジェクトをエクスポート しておくとよいでしょう。

caution

現在インストール済みの 拡張機能 を控えておいてください。アップグレード先の OpenRefine で互換性がない場合があります。拡張機能はワークスペースとインストール先に両方存在し得るため、両方の場所を確認してください。

OpenRefine のインストールまたはアップグレード​

既存のインストールをアップグレードする場合、旧ファイルを削除して新しいファイルを同じ場所に展開してください。古いファイルを上書きすると不要なファイルが残ることがあります。

caution

拡張機能を webapp\extensions フォルダに入れている場合、そのフォルダは削除しないでください。拡張機能はプログラムディレクトリではなくワークスペースディレクトリに入れることもできます。新しいバージョンでの互換性は保証されていません。

Windows では ZIP や MSI などのパッケージの展開を行うため、次のようなコマンドを使って手動インストールできます。

user@machine:~/Downloads$ tar xzf openrefine-3.6.2-linux.tar.gz

展開されたディレクトリに移動し:

user@machine:~/Downloads$ cd openrefine-3.6.2

最後に実行して起動します:

user@machine:~/Downloads/openrefine-3.6.2$ ./refine

拡張機能のインストール​

コミュニティが提供する拡張機能を使うと機能追加や便利なショートカットが手に入ります。把握している拡張機能は拡張機能ページ で紹介しています。

拡張機能を作る

拡張機能の作成・変更をしたい場合は 開発者ドキュメント をご覧ください。問題があれば 拡張機能ページ からそのプロジェクトに移動し issue を報告してください。

インストール先は2通り​

拡張機能は次の 2 箇所のいずれかにインストールできます:

  • プログラムフォルダ内（そのバージョンでのみ有効。アップグレード後は手動で再インストールが必要）
  • ワークスペース内（どのバージョンの OpenRefine でも利用可能）

バージョンをアップグレードするたび再インストールしたい場合など、好みに応じて選択できます。

適切なインストール先を見極める​

プログラムフォルダに入れるなら、webapp\extensions ディレクトリ（存在しない場合は作成）に展開します。

ワークスペースに入れるなら:

各 OS でのワークスペースの見つけ方も こちら にあります。

インストール手順​

拡張機能によって独自の手順があるため、説明をよく読んでから始めてください。

バージョンごとの互換性を確認し、必要なら ダウンロードページ から対応するリリースを入手して issue を投稿してください。

一般的な手順:

  • 拡張機能をダウンロード（通常 GitHub から ZIP 形式）
  • webapp\extensions へ展開し、拡張機能名のフォルダにまとめる
  • OpenRefine を起動または再起動

拡張機能ごとに UI 上の表示方法が異なるため、説明に従って配置場所（メニューなど）を確認してください。