SHOW AVAILABLE OFFERS
SHOW AVAILABLE OFFERS
명령을 실행하는 사용자에게 사용 가능한 오퍼(offers)를 나열하는 명령이에요.
출처: 문서
본문
구문 (Syntax)
SHOW AVAILABLE OFFERS [ LIKE '<pattern>' ] IN LISTING <listing>
파라미터
- LIKE 'pattern' — 객체 이름으로 명령 출력을 선택적으로 필터링해요. 대소문자 무시 패턴 매칭을 사용하며 SQL 와일드카드 문자(%와 _)를 지원해요. 기본값: 없음.
- IN LISTING listing — 표시하려는 오퍼와 연결된 리스팅.
출력 (Output)
명령 출력은 다음 열에 오퍼 속성과 메타데이터를 제공해요:
| Column | Description |
|---|---|
| name | 오퍼 이름. |
| state | 오퍼 상태, DRAFT, PUBLISHED, WITHDRAWN 중 하나. |
| state_updated_on | 오퍼 상태가 마지막으로 업데이트된 날짜와 시간. |
| access_start_date_preference | 소비자 리스팅 접근의 선호 날짜, OFFER_ACCEPTED_DATE 또는 SPECIFIC_DATE 중 하나. |
| contract_value | 총 계약 가치. |
| contract_type | 계약 유형, SUBSCRIPTION, LIMITED_TIME, PAY_AS_YOU_GO 중 하나. |
| contract_duration_months | 계약 기간(월). |
| invoice_start_date_preference | 선호 송장 시작 날짜, OFFER_ACCEPTED_DATE, SPECIFIC_DATE, FIRST_DAY_NEXT_MONTH 중 하나. |
| invoice_start_time | 송장이 시작된 날짜와 시간. |
| is_default | 기본 오퍼가 가격 책정 플랜에 포함되는지 여부, TRUE 또는 FALSE(기본값) 중 하나. |
| display_name | 소비자에게 보이는 오퍼 이름. |
| expiration_time | 오퍼가 만료되는 날짜와 시간. |
| payment_terms | 추가 가격 책정 플랜 파라미터, PAYMENT_TYPE, INSTALLMENT_SCHEDULE, ALLOWED_PAYMENT_METHODS 중 하나. |
| access_end_time | 소비자가 리스팅에 접근할 수 없게 되는 날짜와 시간. |
| access_start_time | 소비자가 리스팅에 접근할 수 있는 날짜와 시간. |
| discount | 오퍼 할인. |
| target_consumer | 오퍼가 대상으로 하는 소비자. |
| terms_of_service | 오퍼와 연결된 서비스 약관. |
| additional_information | 추가 오퍼 정보. |
| pricing_plan | 오퍼와 연결된 가격 책정 플랜. |
| updated_on | 오퍼가 마지막으로 업데이트된 날짜와 시간. |
| attachments | 오퍼에 포함된 PDF 첨부 파일. 각 항목은 5분간 유효한 다운로드 링크를 포함해요. 첨부 파일이 없으면 빈 배열을 반환. |
접근 제어 요구사항 (Access control requirements)
| Privilege | Object | Notes |
|---|---|---|
| PURCHASE DATA EXCHANGE LISTING | Global | 이 권한은 유료 리스팅을 구매할 수 있는 능력을 부여해요. 이 권한이 있는 역할이 없다면 계정 관리자에게 문의하세요. |
사용 메모 (Usage notes)
- 이 명령의 출력을 후처리하려면 파이프 연산자(
->>)나RESULT_SCAN함수를 사용할 수 있어요. 두 구성 모두 출력을 쿼리할 수 있는 결과 집합으로 취급해요. 출력 열 이름은 소문자이므로 출력 열을 참조할 때 큰따옴표로 묶은 식별자를 사용해요(예:SELECT "type").
예시 (Examples)
mylisting에서 이름이 myoffer로 시작하는 모든 사용 가능한 오퍼를 표시해요:
SHOW AVAILABLE OFFERS LIKE 'MYOFFER%' IN LISTING MYLISTING;