추가 SQL 함수 정의 adding-additional-sql-functions
Adobe Campaign을 통해 사용자는 데이터베이스에서 제공하는 함수와 아직 콘솔에서 사용할 수 없는 함수 모두를 포함하여 SQL 함수에 액세스할 수 있는 자체 함수 를 정의할 수 있습니다. 이 기능은 예를 들어 집계 함수(평균, 최대, 합계)에 유용합니다. 이 함수는 콘솔에서 표현식을 "수동"으로 작성(예: 날짜 관리)하는 대신, 서버에서 또는 데이터베이스가 특정 함수를 구현하는 더 쉬운 방법을 제공하는 경우에만 계산할 수 있습니다.
이 메커니즘은 Adobe Campaign 콘솔에서 아직 제공되지 않는 최근 또는 흔하지 않은 데이터베이스 엔진 SQL 함수를 사용하려는 경우에도 사용할 수 있습니다.
이러한 함수가 추가되면 다른 사전 정의된 함수와 마찬가지로 표현식 편집기에 나타납니다.
설치 installation
추가할 함수가 XML 형식 의"package" 파일에 있습니다. 이 파일의 구조는 다음 단락에 자세히 설명되어 있습니다.
콘솔에서 설치하려면 메뉴에서 도구/고급/가져오기 패키지 옵션을 선택한 다음 Install from file 을(를) 선택하고 가져오기 도우미의 지침을 따릅니다.
가져올 패키지의 일반 구조 general-structure-of-package-to-import
추가할 함수는 XML 형식의 "package" 파일 에서 찾을 수 있습니다. 예를 들면 다음과 같습니다.
<?xml version="1.0" encoding='ISO-8859-1' ?>
<!-- ===========================================================================
Additional SQL functions for Adobe Campaign
========================================================================== -->
<package
namespace = "nms"
name = "package-additional-funclist"
label = "Additional functions"
buildVersion= "7.1"
buildNumber = "10000">
<entities schema="xtk:funcList">
<funcList name="myList" namespace="cus">
<group name="date" label="Personalized date">
<function name="relativeMaturity" type="long" args="(<Âge>)" help="Returns the difference between a date and 18 years"
minArgs="1" maxArgs="1" display="Relative maturity of the person born on the date $1">
<providerPart provider="MSSQL,Sybase,PostgreSQL" body="extract(year from age($1))-18"/>
</function>
</group>
</funcList>
</entities>
</package>
-
이름, 네임스페이스 및 레이블 은(는) 정보용으로만 사용됩니다. 설치된 패키지 목록(탐색기/관리/패키지 관리/설치된 패키지)에서 패키지 요약을 볼 수 있습니다.
-
buildVersion 및 buildNumber 필드는 필수입니다. 콘솔이 연결된 서버 번호와 일치해야 합니다. 이 정보는 "도움말/정보" 상자에서 찾을 수 있습니다.
-
다음 블록 entities 및 funclist 은(는) 필수입니다. funcList에서 "name" 및 "namespace" 필드는 필수이지만 이름은 사용자가 결정할 수 있도록 남겨두고 함수 목록을 고유하게 지정합니다.
즉, 네임스페이스/이름 쌍이 동일한 다른 함수 목록(여기서 "cus::myList")을 가져오는 경우 이전에 가져온 함수가 삭제됩니다. 반대로 이 네임스페이스/이름 쌍을 변경하면 가져온 새로운 일련의 함수가 이전 함수에 추가됩니다.
-
group 요소를 사용하여 가져온 함수가 함수 편집기에 나타날 함수 그룹을 지정할 수 있습니다. @name 속성은 이미 존재하는 이름(이 경우 함수가 고려된 그룹에 추가됨) 또는 새 이름(이 경우 새 그룹에 표시됨)일 수 있습니다.
-
미리 알림:
<group>요소의 @name 특성에 사용할 수 있는 값은 다음과 같습니다.code language-none name="aggregate" ( label="Aggregates" ) name="string" ( label="String" ) name="date" ( label="Date" ) name="numeric" ( label="Numeric" ) name="geomarketing" ( label="Geomarketing" ) name="other" ( label="Others" ) name="window" ( label="Windowing functions" )
여러 개의 다른 그룹에 함수를 추가하려면 여러 개의 <group> 요소가 동일한 목록에서 추적되도록 할 수 있습니다.
마지막으로, <group> 요소에는 패키지 파일의 목적인 하나 이상의 함수 정의가 포함될 수 있습니다. <function> 요소는 다음 단락에 자세히 설명되어 있습니다.
함수 설명자 <function></function> function-descriptor--function-
여기에 제공된 대/소문자는 함수 구현 을 제공하려는 일반적인 경우입니다.
아래는 연령을 사용하여 성숙한 것으로 간주된 기간 수를 나타내는 "상대적 성숙" 기능의 예입니다.
<function name="relativeMaturity" type="long" args="(<Âge>)" help="Returns the difference between a date and 18 years"
minArgs="1" maxArgs="1" display="Relative maturity of the person born on the date $1">
<providerPart provider="PostgreSQL" body="extract(year from age($1))-18"/>
<providerPart provider="MSSQL,Sybase,Teradata" body="[Other implementation]"/>
</function>
@name 필드는 함수 이름을 참조하며 "args"는 설명에 표시될 매개 변수 목록입니다. 이 경우 함수는 함수 선택 창에서 "relativeMaturity( <age> )"로 나타납니다.
-
도움말 은(는) 식 편집기 창의 아래쪽에 표시되는 필드입니다.
-
@display 은(는) 정보 메시지입니다.
note note NOTE @help 및 @display 속성에서 문자열 "$1"은(는) 첫 번째 함수 매개 변수(여기서는 "Age")에 제공된 이름을 나타냅니다. $2, $3… 은(는) 다음 매개 변수를 나타냅니다. 아래에 설명된 @body 속성에서 $1은 호출 동안 함수에 전달되는 인수 값을 지정합니다. note note NOTE 설명은 유효한 XML 문자의 문자열이어야 합니다. < 및 > 대신 '<' 및 '>'를 사용하십시오. -
@type 은(는) 함수 반환 형식이며 표준 값(long, string, byte, datetime…)입니다. 생략하면 서버에서 함수를 구현하는 식 내에서 사용 가능한 형식 중 최상의 형식을 결정합니다.
-
@minArgs 및 maxArgs 은(는) 매개 변수의 매개 변수 수(최소 및 최대)를 지정합니다. 예를 들어 매개 변수가 2개인 함수의 경우 minArgs와 maxArgs는 2와 2가 됩니다. 3개의 매개 변수와 1개의 선택적 매개 변수의 경우 각각 3과 4가 됩니다.
-
마지막으로 providerPart 요소는 함수 구현을 제공합니다.
- provider 특성은 필수이며 구현이 제공되는 데이터베이스 시스템을 지정합니다. 예제에서 보듯이 표현식 구문 또는 기본 함수가 다른 경우 데이터베이스에 따라 대체 구현이 제공될 수 있습니다.
- @body 특성에 함수 구현이 포함되어 있습니다. 참고: 이 구현은 코드 블록이 아닌 데이터베이스 언어로 된 표현식이어야 합니다. 데이터베이스에 따라 표현식은 단일 값만 반환하는 하위 쿼리("(select column from table where…)")일 수 있습니다. 예를 들어 Oracle의 경우(쿼리는 대괄호로 작성해야 함)입니다.
note note NOTE 정의된 함수에 의해 하나 또는 두 개의 데이터베이스만 쿼리될 가능성이 있는 경우 이러한 데이터베이스에 해당하는 정의만 항상 제공할 수 있습니다.
'통과' 함수 설명자 pass-through--function-descriptor
특수 함수 설명자는 지정되지 않은 "공급자" 데이터베이스 시스템이 있는 "통과" 블록입니다. 이 경우 "body" 구현에는 사용된 데이터베이스에 종속되지 않은 구문을 사용하는 단일 함수 호출만 포함될 수 있습니다. 한편 "ProviderPart" 블록은 고유합니다.
<function name="CountAll" args="()" help="Counts the values returned (all fields together)"
type="long" minArgs="0" maxArgs="0">
<providerPart body="Count(*)"/>
</function>
이 경우 함수를 추가하는 것은 기본적으로 사용할 수 없었을 데이터베이스 함수를 이제 클라이언트가 볼 수 있도록 하는 역할만 합니다.
예제 examples
추가 함수 예는 사전 정의된 패키지 "xtkdatakitfuncList.xml"에서 찾을 수 있습니다.