メインコンテンツまでスキップ

配送

Music Storyは、メタデータをgz圧縮された改行区切りのJSONファイルとして配信します。 (https://jsonlines.org/).

フル配信は、毎月1回、out/catalog/full_フォルダに配信されます。これらのファイルには、Music Storyカタログのすべてのオブジェクトが含まれています：

  • CustomerName_Artist_YYYYMMDD.json.gz
  • CustomerName_Matching_Artist_YYYYMMDD.json.gz
  • CustomerName_Album_YYYYMMDD.json.gz
  • CustomerName_Matching_Album_YYYYMMDD.json.gz
  • CustomerName_Recording_YYYYMMDD.json.gz
  • CustomerName_Matching_Recording_YYYYMMDD.json.gz
  • CustomerName_Genre_YYYYMMDD.json.gz
  • CustomerName_Role_YYYYMMDD.json.gz
  • CustomerName_Potentially_Mixed_YYYYMMDD.json.gz
  • CustomerName_Potentially_Duplicate_YYYYMMDD.json.gz
  • CustomerName_Potentially_Multi_Artist_YYYYMMDD.json.gz

デイリー配信は、_out/catalog/inc_フォルダに毎日配信されます。デイリー配信**は毎日_out/catalog/inc_フォルダに配信され、前回の配信以降に作成または更新されたMusic Storyカタログのオブジェクトが以下のファイルに格納されます：

  • CustomerName_Artist_YYYYMMDD.json.gz
  • CustomerName_Matching_Artist_YYYYMMDD.json.gz
  • CustomerName_Album_YYYYMMDD.json.gz
  • CustomerName_Matching_Album_YYYYMMDD.json.gz
  • CustomerName_Recording_YYYYMMDD.json.gz
  • CustomerName_Matching_Recording_YYYYMMDD.json.gz
  • CustomerName_Genre_YYYYMMDD.json.gz
  • CustomerName_Role_YYYYMMDD.json.gz
  • CustomerName_Potentially_Mixed_YYYYMMDD.json.gz
  • CustomerName_Potentially_Duplicate_YYYYMMDD.json.gz
  • CustomerName_Potentially_Multi_Artist_YYYYMMDD.json.gz

つまり、オブジェクトのIDが上記のファイルのいずれかにあれば、参照されるオブジェクトも配信される。

毎日配信されるファイルには、Music Storyカタログから削除されたオブジェクトのIDも以下のファイルに含まれている：

  • CustomerName_Deleted_Artist_YYYYMMDD.json.gz
  • CustomerName_Deleted_Matching_Artist_YYYYMMDD.json.gz
  • CustomerName_Deleted_Album_YYYYMMDD.json.gz
  • CustomerName_Deleted_Matching_Album_YYYYMMDD.json.gz
  • CustomerName_Deleted_Recording_YYYYMMDD.json.gz
  • CustomerName_Deleted_Matching_Recording_YYYYMMDD.json.gz
  • CustomerName_Deleted_Genre_YYYYMMDD.json.gz
  • CustomerName_Deleted_Role_YYYYMMDD.json.gz
  • CustomerName_Deleted_Artist_Picture_YYYYMMDD.json.gz

Nb： 各.json.gzファイルには、以下のMD5チェックサムを含む.md5ファイルが添付されている。

ファイルの整合性チェック。

配信方法は、Music StoryがホスティングするSFTPと、お客様が用意するストレージの2つのオプションがあります。

オプション1：Music StoryがホストするSFTP

メタデータファイルはMusic Storyがホスティングしており、公開鍵認証を使ってSFTP（SSH File Transfer Protocol）でアクセスできる：

  • ホスト名： sftp.music-story.com
  • ポート： 2204
  • ルートフォルダ： ~/out
  • ユーザー名：ftp_customername
  • SSH公開鍵： お客様がご用意ください。

ファイルは、SFTPやcurlなど、さまざまなライブラリやツールを使って取得できる。

例えば、こうだ：

$ sftp -P 2204 ftp_customername@sftp.music-story.com
Connected to sftp.music-story.com.
sftp> exit
$ sftp -P 2204 ftp_customername@sftp.music-story.com:~/out/<delivery_file> \
<destination_folder>

メタデータファイルは1ヶ月後にSFTPから削除される。

オプション2：顧客による保管

ファイルは、弊社サーバーの専用SFTPスペースで配信することも、.NETや.NETなどの様々なプロバイダーに直接送信することもできます：

  • アマゾンS3
  • Microsoft Azure Blob Storage
  • グーグル・クラウド・ストレージ
  • Custom FTP/SFTP
  • など（全リストはこちら https://rclone.org/overview/)