엔터티 작업하기

참고

Snowflake Feature Store API는 Snowpark ML Python 패키지(snowflake-ml-python) v1.5.0 이상에서 사용할 수 있습니다.

엔터티는 사용자가 필요한 기능 뷰를 더 쉽게 찾을 수 있도록 항목별로 기능 뷰를 구성합니다. 예를 들어, 비디오 스트리밍 서비스의 기능 저장소는 사용자와 영화에 대한 엔터티를 정의할 수 있습니다. 기능 스토어의 각 기능 뷰는 영화나 사용자, 또는 둘 다와 관련된 것으로 태그가 지정되어 있으며, 사용자는 이러한 엔터티와 관련된 기능 뷰 목록을 검색할 수 있습니다.

엔터티는 기능 뷰를 구성하는 데 도움이 될 뿐만 아니라 추출된 기능을 원본 데이터에 다시 연결하는 데 사용할 수 있는 주요 열의 이름을 저장합니다.

엔터티 만들기

새 엔터티를 생성하여 기능 스토어에 등록하려면 기능 스토어의 register_entity 메서드를 사용합니다. 여기서 fs 는 기능 스토어 인스턴스입니다(특징 저장소 만들기 또는 연결하기 참조).

from snowflake.ml.feature_store import Entity

entity = Entity(
    name="MY_ENTITY",
    join_keys=["UNIQUE_ID"],
    desc="my entity"
)
fs.register_entity(entity)
Copy

엔터티 나열하기

기능 스토어에 등록된 엔터티를 보려면 기능 스토어의 list_entities 메서드를 사용하면 Snowpark DataFrame을 반환합니다. (fs 는 기능 스토어 인스턴스입니다. 특징 저장소 만들기 또는 연결하기 섹션을 참조하십시오).

fs.list_entities().show()
Copy

엔터티 검색하기

기능 스토어의 get_entity 메서드를 사용하여 등록된 엔터티를 검색(예: 조인 키를 가져오기 위해)할 수 있습니다.

entity = fs.get_entity(name="MY_ENTITY")
print(entity.join_keys)
Copy

엔터티 수정하기

기능 스토어의 update_entity 메서드를 사용하여 엔터티의 설명을 업데이트할 수 있습니다.

fs.update_entity(
    name="MY_ENTITY",
    desc="NEW DESCRIPTION"
)
Copy

조인 키와 같은 엔터티의 다른 측면은 변경할 수 없습니다. 다른 측면을 변경하려면 새 엔터티를 생성합니다.

엔터티 삭제하기

기능 스토어의 delete_entity 메서드를 사용하여 엔터티를 삭제할 수 있습니다.

fs.delete_entity(name="MY_ENTITY")
Copy

어떤 기능 뷰에서 참조되는 엔터티는 삭제할 수 없습니다.

알려진 제한 사항

언어: 한국어