미디어 집합

미디어 집합(Media set)은 문서, 이미지, 음성이나 영상 파일을 저장하고 변환하여 Foundry 앱과 온톨로지에서 사용하는 리소스입니다. 스키마 유형은 미디어 종류를, 기본 형식(Primary format)은 저장되는 파일 형식을 정합니다.

지원 스키마와 형식

전용 기능이 있어야 열리는 PDF와 비밀번호, 디지털 서명 또는 암호화로 보호된 PDF는 지원하지 않습니다. XLSX의 복잡한 수식이나 이미지 등 내장 파일을 포함한 일부 고급 기능도 지원하지 않습니다.

추가 입력과 멀티모달

추가 입력 형식(Additional input format)을 지정하면 다른 형식을 받아 기본 형식으로 자동 변환합니다. 지정한 추가 형식만 허용되며 모든 기본 형식이 이 기능을 지원하는 것은 아닙니다. 생성할 때 또는 Details에서 설정합니다. 가상 미디어 집합에는 추가 입력 형식을 구성할 수 없습니다.

예를 들어 DOCX, PPTX와 TXT는 PDF 집합의 추가 입력으로 받아 변환할 수 있지만 기본 파일 형식으로 사용하지는 않습니다.

멀티모달 미디어 집합은 여러 스키마의 파일을 한곳에 받아 모든 파일 형식을 업로드할 수 있습니다. 플랫폼 미리보기는 지원 스키마 항목에만 제공하며 가상 멀티모달 집합에서는 추가 입력 형식의 미리보기도 지원하지 않습니다. 접근 패턴을 적용하기 전에 항목 스키마를 검사하거나 필터링해야 하고 미지원 유형에는 사용할 수 없습니다.

미디어 참조

미디어 참조(Media reference)는 파일을 복사하지 않고 특정 항목을 사용하는 값입니다. 데이터셋의 파일 이름, 페이지 수나 추출 텍스트와 함께 저장하거나 배치 추론의 모델 어댑터 입력으로 사용할 수 있습니다.

Pipeline Builder의 Convert media set to table rows 또는 Python transforms-media의 list_media_items_by_path_with_media_reference로 참조 목록을 만듭니다. 같은 경로를 새 파일로 덮어써도 이전 참조는 원래 항목을 계속 가리킵니다. 영구 보존 삭제가 적용되면 그 항목에는 더 이상 접근할 수 없습니다.

참조는 두 종류를 구분합니다.

• 미디어 집합의 항목 참조는 PDF 텍스트 추출과 OCR 등 Pipeline Builder 미디어 변환에 사용할 수 있습니다.
• 일반 Foundry 데이터셋의 파일 참조는 Get media references (datasets)가 생성합니다. 파일 메타데이터를 표에 연결하는 데 쓸 수 있지만 미디어 집합 항목을 요구하는 Pipeline Builder 변환에는 사용할 수 없습니다.

데이터셋 파일을 미디어 변환에 쓰려면 먼저 MediaSetOutput 같은 경로로 집합에 넣은 뒤 그 집합에서 참조를 만듭니다. 다음 예시는 미디어 집합 참조를 데이터셋으로 쓰고 열 typeclass를 지정하여 인라인 썸네일을 활성화합니다. 중괄호의 RID와 출력 경로는 실제 값으로 치환합니다.

from pyspark.sql import functions as F
from transforms.api import transform, Input, Output
from transforms.mediasets import MediaSetInput


@transform(
    metadata_out=Output("{YOUR_OUTPUT_METADATA_DATASET}"),
    mediaset_in=MediaSetInput("{YOUR_MEDIA_SET_RID}")
)
def compute(ctx, mediaset_in, metadata_out):
    media_references = mediaset_in.list_media_items_by_path_with_media_reference(ctx)
    column_typeclasses = {'mediaReference': [{'kind': 'reference', 'name': 'media_reference'}]} # Enables in-line thumbnails in dataset
    metadata_out.write_dataframe(media_references, column_typeclasses=column_typeclasses)

항목 삭제

항목을 선택하여 Delete를 누르고 확인창에서 다시 Delete를 선택합니다.

삭제 후 목록이 갱신되지만 이 동작은 소프트 삭제입니다. 원시 데이터를 영구 제거하지 않으며 직접 연결된 참조로는 접근할 수 있습니다. 영구 제거에는 보존 정책을 사용합니다.

빌드 파이프라인이 갱신하는 미디어 집합에서는 항목 삭제를 지원하지 않습니다.

사용 경로

가져오기, 가상 집합, 변환, 온톨로지 속성과 Workshop 표시를 연결하여 업무를 만듭니다. 업무 예시는 DICOM, 스프레드시트, 음성, 업로드, 세분화 권한과 OSDK를 다룹니다. 운영 규모와 비용은 연산 사용량 및 한도를 확인합니다.