본문으로 건너뛰기

배달

뮤직 스토리는 메타데이터를 압축된 새줄로 구분된 JSON 파일로 전달합니다 (https://jsonlines.org/).

전체 배송은 한 달에 한 번 폴더로 배달됩니다 out/catalog/full. 다음 파일에는 뮤직 스토리 카탈로그의 모든 개체가 포함되어 있습니다:

  • 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. 여기에는 다음 파일에 마지막 배달 이후 생성되거나 업데이트된 뮤직 스토리 카탈로그의 객체가 포함되어 있습니다:

  • 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가 위의 파일 중 하나에 있는 경우 참조된 개체도 배달에 포함됩니다.

일일 배달에는 뮤직 스토리 카탈로그에서 삭제된 개체의 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 파일이 첨부됩니다.

파일 무결성 검사를 위한 MD5 체크섬이 포함된 .md5 파일이 첨부됩니다.

전송 방법을 결정해야 하며, 뮤직스토리에서 호스팅하는 SFTP 또는 고객이 제공하는 스토리지의 두 가지 옵션을 사용할 수 있습니다.

옵션 1: 뮤직스토리에서 호스팅하는 SFTP.

메타데이터 파일은 뮤직스토리에서 호스팅하며, 공개 키 인증을 사용하여 SFTP(SSH 파일 전송 프로토콜)를 통해 액세스할 수 있습니다:

  • 호스트 이름: 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>

메타데이터 파일은 한 달 후에 SFTP에서 삭제됩니다.

옵션 2: 고객이 제공하는 스토리지

파일은 당사 서버의 전용 SFTP 공간에 전달하거나 다음과 같은 다양한 제공업체로 직접 전송할 수 있습니다:

  • Amazon S3
  • 마이크로소프트 애저 블롭 스토리지
  • 구글 클라우드 스토리지
  • 사용자 지정 FTP/SFTP
  • 등 (전체 목록은 여기 https://rclone.org/overview/)