本記事はUsing Google Sheets as a Makeshift Database for React Appsの和訳です。
ReactでGoogleスプレットシートからデータを取得する方法を調べていて、Metisというライブラリを見つけました。
MetisはReactでGoogleシートをデータベースとして使用するための高階コンポーネントです。
複数のシートからデータを取得して、グローバルな値として利用できます。感覚としてはContext APIに似ています。
React×GoogleシートでSPAを開発するならMetisが一番良いのかな、という所感です。
別途、チュートリアル記事の投稿予定です。
-----以下和訳-----
Reactアプリの仮のデータベースとしてのGoogleスプレッドシートの使用
私たちはカスタムメイドのウェブサイトを作りたいと思っていて、小鳥さんがReactは最近のクールな子供たちが求めているものだと教えてくれました - Wordpressに比べて速くて、拡張性があり、更新が簡単なのですね?
でも、自分たちでコンテンツを更新できるようにしたい。なんでもかんでも、みたいな。あ、Post...え?Postgres?なんだそれ?いや、MySQLも知らない。Firebase?またまた技術専門用語に襲われた気がする! グーグルシートじゃダメなのか?
React と Wordpress を比較したことを謝罪します。 彼らは完全に別の獣であり、異なる目的を果たしていますーーーReactはJavascriptフレームワークであり、Wordpressはコンテンツ管理システム(CMS)です。Wordpressを椅子に縛り付けて、Hostel(3つの部分すべて)のようにしたり、ペイトリオッツのファンがトム・ブレイディを崇拝しているように、Wordpressを賞賛したりすることもできます(ごめんなさい、私はいつまでも永遠にイーグルスのファンなのです)。しかし、私は、私が知っている他のほとんどの人々のように、Wordpressから移行しました。理由は様々だが、Redditに最も適した理由だと思います。さて、Reactの話に戻りましょう。
バックグラウンド
私は数年前、ボランティアのスタートアップEvoXLabsの一環として、FAWN Initiative (Free and Accessible Websites for Nonprofits)を運営していました。ほとんどの場合、これらのウェブサイトは情報を提供するもので、頻繁に更新が必要でした。しかし、このイニシアチブの背後にあるアイデアは、ウェブサイトのアクセシビリティを促進し、提唱することだったので、更新は取引の一部ではありませんでした。これはReactが選ばれた理由の一つでもあります。魔法のようにウェブサイトをアクセシブルにするのではなく、アクセシビリティを全く考慮して作られた、視覚的にも機能的にも魅力的なウィジェットの束ではなかったからです。AngularやVueもほとんど同じだったでしょうが、Reactは毒だったのです。とにかくアップデート。組織のスタッフやボランティアがReactを使いこなせるか、従来のデータベースを使ってナビゲートできるかの2つです。これはすぐに問題となり、需要に追いつくためのリソースが不足していたため、FAWN Initiative は活動を休止し、現在に至っています。
Googleスプレッドシートへ
約1年前、私はReact開発者として、自分が大切にしている活動に貢献できる別の方法を考え始めました。非営利団体が自分でコンテンツを追加/削除/修正する際のボトルネックになることなく、非営利団体のためのウェブサイトを作ることはできないだろうか?そこで私は、一般的に人々が情報を保存したり取得したりするためにウェブ上で最も一般的に使われているツールは何かを尋ね始めました。テックの世界では、それに対する答えは、それ自体が本になるようなリストになっています。テックの世界以外では、Google Sheetsが唯一の答えとなっています。Excel/CSVファイルはそのリストの2番目にありましたが、変更を加えてファイルを展開するプロセス全体について、人々は躊躇していました。幸いなことに、Google Sheetsは他のほとんどのGoogle製品と同様に、非常に素晴らしいAPIを持っています。そして、APIあるところに光あり。
**Google Sheetsには伝統的なデータベースとの比較がなく、伝統的なデータベースの代わりになるものではないです。**しかし、その場しのぎのデータベースとしてのGoogle Sheetsが本当に有益であるかもしれない点の1つは、伝統的なデータベースでは追加の手段で処理されていた、履歴の追跡性です。
技術の話
さて、APIを用意しました。ReactはJavascriptのフレームワークです。fetchコールでいいんだよね?お好みであればaxiosも 簡単でしょう?うーん、そうでもない。
Reactの優れた点の一つはルーティングです。ページをナビゲートするときにページ全体をリロードする必要がなく、サブコンポーネントだけをナビゲートすることができます。これが高速な理由です。では、いくつかのコンポーネント(この文脈ではページと同義)を持っていて、それぞれがfetch
コールを持っているとしましょう。何が起こるでしょうか?コンポーネントがロードされるたびに(`fetchコールがどこに置かれているかにもよりますが)、ネットワークコールが発生します。そして、ネットワークコールはパフォーマンスを大幅に低下させる可能性があります。しかし、それだけではありません。Google SheetsのAPIコールが行われるたびに、コール数のノルマに照らし合わせてカウントされます。
Google Sheets API v4のUsage Limitsの項より引用:
このバージョンのGoogle Sheets APIでは、プロジェクトごとに100秒あたり500リクエスト、ユーザーごとに100秒あたり100リクエストという制限があります。読み取りと書き込みの制限は別々に追跡されます。1日の利用制限はありません。
長い話を短くすると、これらの制約を考えると、私たちが本当に望むのは、ネットワークコールを可能な限り制限することです。これにより、ホームページの高速化が図られ、ノルマを最大限に活用しています。予想されるトラフィックが使用制限を超えている場合は、従来のデータベースがあなたのニーズに最も適しているかもしれません。後述の「Googleシートを使わないとき」では、このようなシナリオを取り上げています。
メティスとは
Metisは、ReactアプリがGoogle SheetsをMakeshiftデータベースとして使用できるようにする高次コンポーネント(HOC)です。ご存知の方もいらっしゃるかもしれませんが、Metisはギリシャの知恵の女神にちなんで名付けられました。Metisには主に2つのコンポーネントがあります。GoogleSheetsProvider
とwithGoogleSheets
です。
GoogleSheetsProvider
はReactのContext.Providerに非常に似ています。これはReactアプリをラップし、Google Sheets Docからすべてのシートを取得し、APIからの生の結果を読み取り可能なkey/value(kv)のストアに変換し、このkvストアをコンテキストに公開します。これにより、コンポーネントツリーのどこからでもkvストアにアクセスできるようになります。
withGoogleSheets
は、特定のシートのデータをコンテキストから取得し(GoogleSheetsProvider
を介して)、propsを介してコンポーネントで利用できるようにするための高次コンポーネントです。
デフォルトでは、withGoogleSheets
は、Google Sheets APIからのデータ取得に失敗した場合(不正なパーミッション、クォータに達した場合など)にレンダリングするための非常に基本的なコンポーネントが同梱されています。このHOCでは、このデフォルトのコンポーネントをカスタマイズしたり、全く異なるカスタムコンポーネントに置き換えることができます。
withGoogleSheets
は、単一のシート名またはシート名の配列を引数にとり、データを取得するように設計されています。それぞれを個別に指定せずにすべてのシートを取得することもサポートされており、例を挙げてよく説明されています。
基本的な例
インストール
npm install react-db-google-sheets --save
.env
REACT_APP_GOOGLE_SHEETS_API_KEY=[YOUR-API-KEY]
REACT_APP_GOOGLE_SHEETS_DOC_ID=[YOUR-DOC-ID]
App.js
import React from 'react';
import GoogleSheetsProvider from 'react-db-google-sheets';
const App = () => (
<GoogleSheetsProvider>
<MyApp />
</GoogleSheetsProvider>
);
export default App;
Component (say Hello.js)
import React from 'react';
import { withGoogleSheets } from 'react-db-google-sheets';
const Hello = props => (
<div>
{props.db.sheet1.map(data => (
<span>{data.id}</span>
))}
</div>
);
export default withGoogleSheets('sheet1')(Hello);
その他の例はドキュメントやGitHubレポジトリのexamples subfolderに記載されています。
Googleスプレッドシートの使用が不適な時
願わくばそろそろ、Google SheetsをReact Appsのためのその場しのぎのデータベースとして使うというアイデアに、少なくとも興味をそそられていることでしょう。しかし、これが良い解決策ではないというシナリオをいくつか考えているかもしれません。その通りです - そのようなケースはいくつかあります。プログラミングの世界では文字通りすべてのことがそうであるように、ツールの使い方はニーズに依存していて、Metisも例外ではありません。
第一に、先に述べたように、もしあなたのウェブサイトに大量のトラフィックが来ることが予想される場合は、GoogleSheetsProvider
を使用して、最初のウェブサイトの負荷ごとに1つのネットワークコールを制限しても、伝統的なデータベースを使用するか、Google Sheets APIの使用のための有料プランを検討する必要があります。第二に、Google Sheetsをその場しのぎのデータベースとして使用するためには、ドキュメントのパーミッションを公開可能に設定する必要があります。そのため、もしあなたのデータにパスワードや機密情報が含まれていて、ユーザーのアクセス権限を保証する必要がある場合は、従来のデータベースを使用し、適切なセキュリティプロトコルを実装する必要があります。Metisやその場しのぎのデータベースとしてのGoogle Sheetsの使用は、情報提供サイトや履歴書・ポートフォリオサイトのように、一般に公開されているデータを対象としています。
最後に、外部キー(テーブル間の相互参照の役割を果たす列、Google Sheetsの用語ではシート)が必要な場合は、リレーショナルデータベースを使用した方が良いでしょう。Metisは、将来的にはGoogle Sheetsを使ったリレーショナルデータベースを実現するためのヘルパー機能やガイドラインを提供する予定ですが、自分のニーズを評価し、ユースケースに最適なツールを決定することを強くお勧めします。
Updated:
何人かの人と話したのですが、Google Sheetsはそれ自体がデータベースではないことを再確認する価値があります。それはスケーラブルではないし、伝統的なデータベースの利点を利用していません。しかし、スケーラビリティが問題ではなく、CMSを構築することが非現実的であり、技術に精通していないコンテンツの管理者に新しいツールを教える必要がある場合には、オーバーヘッドが高すぎるというような非常に特殊なユースケースでは、Metisは有益なものになるかもしれません。ニーズとユースケースを評価し、目的に合ったツールを選択することは本質的に重要です。
終わりに
Metisは、コードの変更や展開のプロセスなどを気にすることなく、Google Sheetsを使った簡単な操作でWebサイトのコンテンツの追加/変更/削除ができるツールを目指しています。また、Google Sheets Doc上のシートに色やフォントサイズなどを指定して、Webサイトのデザインやレイアウトを管理することもできます。可能性は無限大で、使いやすさはとてつもなくセクシーです。しかし、繰り返しになりますが、あなたはあなたのニーズを評価し、あなたの要件に最適なツールを選ぶ必要があります。
Metisを使ってみましょう。フィードバック、貢献、質問、すべて大歓迎です。GitHubレポジトリに問題を書き込んだり、メールやTweetで質問やフィードバックを送ってください。
参考
React開発効率を3倍にするVS Code拡張機能&環境設定
React初案件獲得までの流れ(学習・案件探し・面接・契約まで)
The Complete React Developer Course (w/ Hooks and Redux)
Universal React with Next.js - The Ultimate Guide
React Native入門:ニュースアプリを作りながら覚えよう/Hooks対応 2020年版
React.js & Next.js超入門
Webサイト高速化のための 静的サイトジェネレーター活用入門
詳解! Google Apps Script完全入門 ~Google Apps & G Suiteの最新プログラミングガイド