kintoneでCSVやExcelのファイルからレコードを上書き更新するには、読み込み時の設定で「レコードの更新と追加」を選び、更新キーとなるフィールドを指定します。更新キーの値がアプリ内の既存レコードと一致すれば上書きされ、一致しなければ新規登録になります(2026年10月時点)。更新キーには、ほかのレコードと値が重複しないフィールドを指定する必要があります。
読み込み時に「レコードの更新と追加」を選び、更新キーを指定する
ファイルを読み込む画面では、まず「ファイル読み込み時の［アプリへの反映方法］を選択します」という手順があり、選択肢は「［レコードの追加のみ］」と「［レコードの更新と追加］」の2つです。「［レコードの更新と追加］を選択した場合は、アプリのどのフィールドを［更新キー］とするのかと、読み込むファイルのどの列と対応させるのかを設定します」。更新キーの役割は、公式ヘルプに「［更新キー］とは、アプリのレコードと読み込むファイルの行をひも付けるためのアプリのフィールドです」と説明されています。この設定をせずに「レコードの追加のみ」のままファイルを読み込むと、既存レコードの数に関わらず、ファイルの行がすべて新規レコードとして登録されます。
更新キーには、ほかのレコードと値が重複しないフィールドを指定する
更新キーに選べるフィールドには条件があります。公式ヘルプには「［更新キー］には、［レコード番号］や受注番号など、同じアプリ内でほかのレコードと値が重複しないフィールドを指定します」とあります。受注番号や品番のような、1レコードにつき1つの値しか持たない項目が向いています。レコード番号を更新キーにする場合は、「「ファイルに記載されたレコード番号」と「アプリに登録されているレコードのレコード番号」が一致すると、そのレコード番号が記載されたファイルの行のデータで、一致したレコードの内容を更新します」という動きになります。値が重複するフィールドを選ぶと、どのレコードを更新すべきかが1件に決まりません。
自分のアプリで、更新キーに選んだフィールドの値が重複していないかを確かめる手順
更新キーに使う予定のフィールドを決めたら、そのフィールドの一覧を開き、同じ値のレコードが無いかを並び替えて見ます。見当たらなければ、少数のレコードで試しに「レコードの更新と追加」で読み込み、更新したいレコードだけが変わったかを確認します。意図しないレコードが更新されていた場合、更新キーの値がどこかで重複している可能性があります。
更新キーが一致しない行は新規登録になる
「レコードの更新と追加」を選んでいても、ファイルの行の更新キーの値がアプリ内のどのレコードとも一致しない場合は、その行は新規レコードとして追加されます。更新したいつもりで用意したファイルでも、更新キーの列の値が1文字でも違えば別のレコードとして増えてしまうことになります(2026年10月時点)。CSVを作る側で更新キーの値を書き換えていないか、文字の全角半角や前後の空白が元のデータとそろっているかを、読み込み前に確認しておく必要があります。
