소스 별칭과 설치 환경 매핑

소스 별칭(Source alias)은 Data Connection 소스를 이름으로 참조하는 기능입니다. TSv2와 Python 함수에서 특정 소스 RID를 코드에 고정하지 않고 환경별 원천을 연결할 수 있습니다.

소스 가져오기와 이름 설정

Resource imports의 Ontology SDK 탭에서 Add > Sources를 열고 사용할 소스를 고른 뒤 Confirm selection을 선택합니다.

Sources 목록에서 소스 이름 아래의 Add alias로 별칭을 만듭니다. 키는 저장소 안에서 고유해야 합니다.

연필 아이콘으로 별칭을 편집합니다. 선언과 조회에 사용하는 키가 일치해야 합니다.

HTTPS 소스 사용

다음 예제는 HTTPS 연결을 제공하는 소스를 demoSource라는 별칭으로 구성한 경우입니다. 외부 내보내기와 코드 가져오기 및 전송 권한은 외부 API 구성을 먼저 충족해야 합니다.

TSv2의 myExternalFunction.ts입니다. config의 sources와 getSource에 같은 키를 사용합니다.

import { getSource, getHttpsConnection, getFetch } from "@palantir/functions-sources";

export const config = { sources: ["demoSource"] };

export default async function myExternalFunction(): Promise<string> {
    const source = await getSource("demoSource");
    const { url } = getHttpsConnection(source);
    const fetch = await getFetch(source);
    const response = await fetch(url);
    if (!response.ok) {
        throw new Error(`External API returned HTTP ${response.status}`);
    }
    return response.text();
}

Python에서는 sources 선언과 get_source를 맞춥니다.

from functions.api import function
from functions.sources import get_source


@function(sources=["demoSource"])
def my_external_function() -> str:
    source = get_source("demoSource")
    connection = source.get_https_connection()
    response = connection.get_client().get(connection.url)
    response.raise_for_status()
    return response.text

소스 RID 자체가 필요하면 TSv2의 Aliases.source("demoSource").rid, Python의 functions.aliases.source("demoSource").rid를 사용할 수 있습니다.

Marketplace 매핑

제품에 함수를 추가하면 별칭 소스가 Data connection sources 입력으로 나타납니다. 설치자는 대상 환경에서 사용할 소스를 선택하고 Marketplace가 그 소스를 같은 별칭에 매핑합니다.

Inputs에서 소스를 선택하고 Details > General에 필요한 연결의 설명을 넣을 수 있습니다.

설치자는 설명을 확인하고 실제 사용할 소스를 선택합니다. 함수 코드는 바꾸지 않아도 됩니다.