CSVファイルからのレコードインポート

データベースに大量のデータをアップロードして、.CSVファイルを使用してインポートします。テキスト、日付、および数字をフォーマットし、消毒して、常にクリーンなインポートを行います！

スキルレベル: 中級

開始する前に

• データベースについて知っており、それを作成する基本的な方法を知っていること。

• サンプルアプリをクローンし、サンプルCSVファイルをダウンロードします。

• 50レコードまでこの機能を使用するには、有料のAdaloプランは必要ありません。

手順

シンプル

1.) データベースにレコードを手動で追加する別の方法は、CSVファイルをデータベースにインポートすることです。まず、Adaloビルダーの左側のメニューでDatabaseボタン をクリックし、次にインポートしたいコレクション内のRecords をクリックします。

2.) CSVをアップロードするには、レコードビューの右上にあるアップロードボタン をクリックし、ファイルを選択 をクリックして、コンピューター上のファイルを選択してアップロードします。CSVがない場合は、サンプルアプリで試してみたい場合は、こちらをクリックしてCSVファイルをダウンロードし、こちらをクリックしてサンプルアプリをクローンします。

3.) AdaloはCSVファイル内の列をデータベース内の存在するプロパティと自動的にペアにしようとします。CSV内の特定の列をインポートしないように選択したり、自動的に同期されなかった場合は手動で割り当てることができます。CSV内で正しくフォーマットされていれば、ほとんどのプロパティタイプをマッチングできます。各プロパティタイプを適切にフォーマットする方法については、以下の表を参照してください。

プロパティ	フォーマット
Text	どんな書式でも機能します
Number	整数、小数、または負の数である必要があります。記号や文字は使用しないでください。
True/False	値は**true**であるか、falseであるかを示すために空白にしてください。
Date	MM/DD/YYYYまたはYYYY-MM-DDの形式で入力してください。
Date and Time	ISO 8601形式で入力してください。例: 2022-07-04T02:00:00Z。Adaloはすべての日時をUTCとして解釈します。
Image	インポートには対応していませんが、ストレージURLの場所はテキストとしてインポートできます。
File	インポートにはサポートされていませんが、ストレージのURL場所はテキストとしてインポートできます。
Relationships	One-to-Many: 他のコレクションのレコードの最初のプロパティが同一である限り、ペアリングできます。 たとえば、ユーザー [e-mail] との関係を持つ Trips をインポートする場合、Users コレクションにはこのメールアドレスのユーザーが存在し、かつコレクションの最初のプロパティとして Email が設定されている必要があります。 Many-to-Many: インポートにはサポートされていません。

4.) CSVの列とプロパティをペアリングしたら、Import Data をクリックします 。すべてがうまくいけば、"Import Successful" メッセージが表示されます。エラーが発生した場合は、次のトラブルシューティング手順を実行してください：

• レコードを10000件以下のバッチでアップロードしてみてください。

• 既存のレコードと関係フィールドが 完全に 一致していることを確認し、コレクションの最初のプロパティ（またはラベル）がCSVの列の値と一致していることを確認してください。

• ラベルフィールド（コレクションの最初のプロパティ）がテキストまたは数値フィールドであることを確認してください。

• 日付形式が正しいことを確認してください

In-Depth

1.) データベースにレコードを手動で追加する別の方法は、CSVファイルをデータベースにインポートすることです。まず、Adaloエディタの左側メニューでデータベースボタン をクリックし、インポートしたいコレクションの Records をクリックします。

2.) CSVをアップロードするには、レコードビューの右上にあるアップロードボタンをクリックします 、次に Select a File をクリックしてコンピューター上のファイルを選択します。CSVファイルがない場合は、サンプルアプリで試してみたい場合は、こちらをクリックして CSVファイルをダウンロードし、こちらをクリックして サンプルアプリをクローンします。

3.) Adalo は、CSV ファイル内の列をデータベース内のプロパティと自動的にペアリングしようとします。ドロップダウンメニューで None を選択することで特定の列をインポートしないように選択することができます。自動的に同期されなかった場合は、手動で割り当てることもできます。CSV で正しくフォーマットされている場合、ほとんどのプロパティタイプをマッチングさせることができます。各プロパティタイプの適切なフォーマット方法については、以下の表を参照してください。

プロパティ	フォーマット
Text	どのようなフォーマットでも機能します
Number	整数、小数、または負の数である必要があります。記号や文字は含めません。
True/False	値は true であるか、false であるかを示すために空白にする必要があります。
Date	MM/DD/YYYYまたはYYYY-MM-DDの形式でフォーマットする必要があります
Date and Time	**2021-08-19T17:23:10Z**などのISO 8601形式である必要があります。Adaloはすべての日時をUTCとして解釈します。このコンバーターを使用して日付をこの形式に変換できます。
Image	インポートには対応していませんが、ストレージURLの場所はテキストとしてインポートできます。
File	インポートには対応していませんが、ストレージURLの場所はテキストとしてインポートできます。
Relationships	One-to-Many: 他のコレクションのレコードの最初のプロパティが同一であれば、マッチングできます。たとえば、ユーザー[e-mail]と関係のあるTripsをインポートする場合、Usersコレクションにはこのメールアドレスを持つユーザーが存在し、コレクションの最初のプロパティとしてEmailが設定されている必要があります。 Many-to-Many: インポートには対応していません。

4.) CSVの列とプロパティをペアリングしたら、Import Dataをクリックします 。すべてがうまくいくと、「Import Successful」というメッセージが表示され、その後Doneをクリックできます。エラーが発生した場合は、次のトラブルシューティング手順を実行してください：

• レコードを10,000件以下のバッチでアップロードしてみてください。

• 任意の関係フィールドが既存のレコードと_完全に_一致し、コレクションの最初のプロパティ（またはラベル）がCSVの列の値と一致していることを確認してください。

• ラベルフィールド（コレクションの最初のプロパティ）がテキストまたは数値フィールドであることを確認してください。

• 日付形式が正しいことを確認してください

例

インポートが完了すると、新しいレコードがデータベースに表示されます。

この手順で使用されているサンプルアプリをクローンしたり、自分で試すためにサンプルCSVをダウンロードすることができます。

もっと詳しく

• CSVの列名は、Adaloのプロパティ名と完全に一致する必要はありません。\

• 列は、コレクションのプロパティと同じ順序である必要はありません。\

• 通常、1万件以下のレコードをバッチ単位でアップロードするのが最適ですが、それ以上のレコードをアップロードしても成功することは珍しくありません。\

• CSVのインポートは既存のデータベースレコードを上書きしません。追加のみ行います。

ヘルプ

この記事に関する追加のヘルプが必要な場合は、いつでもコミュニティフォーラムで質問できます！投稿にこの記事へのリンクを貼り付けることも忘れずに！

チュートリアルやヘルプドキュメントのリクエストがありますか？お知らせください！

tags: cvs, csv, import, upload