Srushサポートサイト

サービス連携基本仕様

日付
2026.03.25

サービス連携

「サービス連携」から各社サービスとデータ連携の設定をします。

  1. srushの管理画面へログインします。
  2. データシート ＞ サービス連携 ＞ 連携したいサービス名を検索 ＞ 押下

差分同期で一意キーにファイル内の列名が出てこない、全データ同期が赤×で失敗する

ファイルの内容によってファイル内のデータが正常に取得できず、一意キー選択時に列名が表示されない場合、あるいは全データ同期が赤×で失敗する場合があります。

それでも改善されない、もしくは文字コードが「shiftjis」の場合は接続設定の「スキーマ」を指定する必要があります。

以下の形ですべての列名を並べ、「スキーマ」の入力欄に設定してください。

{"列名1": "string", "列名2": "string"}

サービス連携：オブジェクト一覧の設定

  1. 名前

    任意のお好きなものを入力してください。

  2. フォーマット

    連携対象のファイルの形式を選択してください。

    ここでは CSV Format を選択した場合を例に説明します。

  3. ヘッダーの定義

    CSVのヘッダー(カラム名)の定義方法を選択します。 From CSV を選択してください。

    ※ From CSVはCSV中のヘッダーからヘッダーを定義する方法です

    ‣
    任意の設定項目
    💡

    通常、以下項目はデフォルトから変更する必要はございません。
    デフォルトの設定でうまく連携出来ない場合にご設定ください。

    1. 文字コード

      CSVの文字コードを指定します。
      デフォルトの utf8 で文字化けする場合、 shiftjis や 932 をお試しください。

    2. ヘッダーの前の行をスキップ

      ヘッダー行の前にスキップする行数を指定します。

      ヘッダー行がCSVの1行目にある場合はデフォルトの 0 を、3行目にある場合は 2 をご指定ください。

    3. フィールドの不一致に関するエラーを無視する

      CSVのフィールド数とスキーマのカラム数が一致しない場合に発生するエラーを無視するかどうかを選択してください。

    4. True値

      真の値として解釈されるべき大文字小文字を区別する文字を指定してください。

    5. 文字列はNULLにすることができます

      文字列をNULLとして解釈するかどうかを選択してください。

    6. False値

      偽の値として解釈されるべき大文字小文字を区別する文字を指定してください。

    7. エスケープ文字

      エスケープ文字を指定してください。エスケープを無効にするには、このフィールドを空白のままにします。

      よく使用される文字はバックスラッシュ ( \) です。たとえば、次のデータがあるとします。

      Product,Description,Price
Jeans,"Navy Blue, Bootcut, 34\"",49.99

      バックスラッシュ ( \) は、2 番目の二重引用符 ( ) の直前に使用され、"それがフィールドの閉じ引用符ではなく、値に含めるリテラルの二重引用符文字であることを示します (この例では、ジーンズのサイズをインチで示しています: 34")

    8. 区切り文字

      CSVデータ内の個々のセルを区切る文字をご指定ください。1文字のみ入力可能です。
      タブ区切りの場合は \t と入力してください。

    9. Null値

      Null値として解釈されるべき大文字小文字を区別する文字列の集合を指定してください。

      例えば、値「NA」を null として解釈する場合は、このフィールドに「NA」と入力します。

    10. 二重引用符

      引用符で囲まれたCSV値の中の二重引用符が、データの中の1つの引用符を表すかどうかを選択してください。

    11. 引用文字

      CSV値の引用符付けに使用する文字をご指定ください。

      引用符で囲まないようにするには、このフィールドを空白にします。

    12. ヘッダー後の行をスキップ

      ヘッダー行の後にスキップする行数を指定します。

任意の設定項目

  1. パス パターン（必須）

    どのファイルを選択するかを指定するためのパターンを入力してください。

    ‣
    例）
    • ** (デフォルト):すべてに一致します。
    • **/file.csv：特定のファイル名と拡張子を持つファイルと一致します。
    • **/*.csv: 特定の拡張子を持つすべてのファイルと一致します。
    • myFolder/**/*.csv: myFolder の下にあるすべての csv ファイルに一致します。
    • */**: 少なくとも 1 つのフォルダーの深さにあるすべてのものに一致します。
    • */*/*/**: 少なくとも 3 つのフォルダーの深さにあるすべてのものと一致します。
    • **/file.*|**/file: 拡張子が任意の（または拡張子なしの）「file」という名前のすべてのファイルに一致します。
    • x/*/y/*

      : サブフォルダー x -> 任意のフォルダー -> フォルダー y にあるすべてのファイルに一致します。

    • **/prefix*.csv: 特定のプレフィックスを持つすべての csv ファイルに一致します。
    • **/prefix*.parquet: 特定のプレフィックスを持つすべての parquet ファイルに一致します。
💡
通常、以下項目はデフォルトから変更する必要はございません。
デフォルトの設定でうまく連携出来ない場合にご設定ください。
  1. スキーマレス

    ストリーム（オブジェクト）のスキーマに対してレコードの検証や構造化を行わないかどうかを選択します。

  2. スキーマ

    ファイルから抽出されたレコードを検証するために使用されるスキーマ（カラム定義）を入力します。設定した場合、受信ファイルから自動検出されるオブジェクトのスキーマを上書きします。

  3. 検証ポリシー

    レコードがストリームスキーマに準拠していない場合、同期の動作を指示する検証ポリシーの名前を選択します。

  4. 履歴がいっぱいの場合に同期するまでの日数

    履歴がいっぱいの場合に同期するまでの日数をご入力してください。

    ファイル・ストアの状態履歴がいっぱいになると、シンクは指定された日数の範囲で最後に更新されたファイルのみを読み込みます。

サービス連携：オブジェクト選択

  1. どのオブジェクトをSrushに連携するかを選択します。
    💡

    データ量に応じて取得時間も増えますので、必要なオブジェクトのみに絞り込んでいただくのがおすすめです。

  2. データ同期方式

    データ同期方式を選択してください。

    通常はデータ転送量の少ない 差分同期 を 推奨します。 差分同期 で問題がある場合は 全データ同期 をご選択ください。

    1. 全データ同期
    2. 差分同期
      1. 更新キー

        _ab_source_file_last_modified のみ選択可能です。

      2. 一意キー

        ユニークな列名（IDなど）を選択してください。

全データ同期

更新の際に、毎回すべてのデータを取得して同期します。

※連携元に日次や週次でファイルが増えていくような場合は、年月が経過するにつれてデータ量が膨大になり更新が終わらなくなってしまうなどの問題が発生するため差分同期をお願いします。

差分同期

更新の際に、差分のデータを判別して同期します。

差分の判別には「更新キー」「一意キー」が必要です。

更新キー

時系列の判別に使われる情報です。

「_ab_source_file_last_modified」のみ選択可能です。

「_ab_source_file_last_modified」とは、連携元のファイルの更新日です。

更新キーをみて、どのデータが新しいのかを判別します。

一意キー

データの特定に使われる情報です。

連携元のファイルにある列の中から1つ選択可能です。

たとえばIDなど、ユニークに割り当てられる列を選択してください。

一意キーをみて、同期済のデータなのか、新しいデータなのかを判別します。

更新条件

差分同期では、以下のように同期が行われます。

  • 一意キーが異なる場合、新しいデータとして同期
  • 一意キーが同一で更新キーが異なる場合
    • 更新キーが新しければ新しい方のデータで上書き
    • 更新キーが古ければそのまま（Srush上のデータは上書きされない）
サービス連携のフォルダについて連携シートの削除方法サービス連携のエラーメッセージ確認方法連携シートの削除方法ファイル連携のフォルダについて