SHOW AVAILABLE OFFERS¶

Répertorie les offres qui sont disponibles pour l’utilisateur qui exécute la commande.

Syntaxe¶

SHOW AVAILABLE OFFERS [ LIKE '<pattern>' ] IN LISTING <listing>

Copy

Paramètres¶

LIKE 'pattern'

(Facultatif) Filtre la sortie de commande par nom d’objet. Le filtre utilise une concordance de motif insensible à la casse avec prise en charge des caractères génériques SQL (% et _).

Par exemple, les motifs suivants donnent les mêmes résultats :

... LIKE '%testing%' ...

... LIKE '%TESTING%' ...

. Par défaut : aucune valeur (aucun filtrage n’est appliqué à la sortie).

IN LISTING listing: Liste associée à l’offre que vous souhaitez afficher.

Sortie¶

La sortie de commande fournit les propriétés et les métadonnées dans les colonnes suivantes :

Colonne	Description
`name`	Nom de l’offre.
`state`	État de l’offre, l’un des suivants : DRAFT PUBLISHED WITHDRAWN
`state_updated_on`	Date et heure de la dernière mise à jour de l’état de l’offre.
`access_start_date_preference`	La date préférée pour l’accès des consommateurs aux listes, une parmi : OFFER_ACCEPTED_DATE SPECIFIC_DATE
`contract_value`	Valeur totale du contrat.
`contract_type`	Le type de contrat, l’un des suivants : SUBSCRIPTION LIMITED_TIME PAY_AS_YOU_GO
`contract_duration_months`	Durée du contrat en mois.
`invoice_start_date_preference`	La date de début de facturation préférée, une des suivantes : OFFER_ACCEPTED_DATE SPECIFIC_DATE FIRST_DAY_NEXT_MONTH
`invoice_start_time`	Date et heure de début de la facturation.
`is_default`	Spécifie qu’une offre par défaut est incluse dans le plan tarifaire, l’une des offres suivantes : TRUE FALSE (par défaut)
`display_name`	Nom de l’offre visible par les consommateurs.
`expiration_time`	Date et heure d’expiration de l’offre.
`payment_terms`	Paramètres du plan tarifaire supplémentaires, l’un des éléments suivants : PAYMENT_TYPE INSTALLMENT_SCHEDULE ALLOWED_PAYMENT_METHODS
`access_end_time`	Date et heure auxquelles les consommateurs perdent l’accès à la liste.
`access_start_time`	Date et heure auxquelles les consommateurs peuvent accéder à la liste.
`discount`	Remise de l’offre.
`target_consumer`	Le consommateur cible de l’offre.
`terms_of_service`	Conditions de service associées à l’offre.
`additional_information`	Informations complémentaires sur l’offre.
`pricing_plan`	Plan tarifaire associé à l’offre.
`updated_on`	Date et heure de la dernière mise à jour de la l’offre.

Exigences en matière de contrôle d’accès¶

Privilège	Objet	Remarques
PURCHASE DATA EXCHANGE LISTING	Global	Ce privilège accorde la possibilité d’acheter une liste payante. Si vous ne disposez pas d’un rôle avec ce privilège, contactez l’administrateur de votre compte.

Pour obtenir des instructions sur la création d’un rôle personnalisé avec un ensemble spécifique de privilèges, voir Création de rôles personnalisés.

Pour des informations générales sur les rôles et les privilèges accordés pour effectuer des actions SQL sur des objets sécurisables, voir Aperçu du contrôle d’accès.

Notes sur l’utilisation¶

Pour post-traiter la sortie de cette commande, vous pouvez utiliser l’opérateur de canal (->>) ou la fonction RESULT_SCAN. Les deux constructions traitent la sortie comme un jeu de résultats que vous pouvez interroger.

For example, you can use the pipe operator or RESULT_SCAN function to select specific columns from the SHOW command output or filter the rows.

When you refer to the output columns, use double-quoted identifiers for the column names. For example, to select the output column type, specify SELECT "type".

You must use double-quoted identifiers because the output column names for SHOW commands are in lowercase. The double quotes ensure that the column names in the SELECT list or WHERE clause match the column names in the SHOW command output that was scanned.

Exemples¶

Afficher toutes les offres disponibles dont le nom commence par myoffer dans mylisting :

SHOW AVAILABLE OFFERS LIKE 'MYOFFER%' IN LISTING MYLISTING;

Copy