SHOW OFFERS¶

Fournit des informations sur toutes les offres ajoutées à une liste.

Syntaxe¶

SHOW 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
`comment`	Commentaires sur l’offre ajoutée par le fournisseur.
`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
`pricing_plan_name`	Plan tarifaire associé à l’offre.
`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.
`updated_on`	Date de la dernière mise à jour de l’offre.

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

Privilège	Objet	Remarques
CREATE LISTING	Compte	Only the ACCOUNTADMIN role has this privilege by default. The privilege can be granted to additional roles as needed.

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.

Les noms des colonnes de sortie pour cette commande sont générés en minuscules. Si vous consommez un jeu de résultats de cette commande avec l’opérateur de canal ou la fonction RESULT_SCAN, utilisez des identificateurs entre guillemets doubles pour les noms de colonnes de la requête, afin de vous assurer qu’ils correspondent aux noms de colonnes dans la sortie analysée. Par exemple, si le nom d’une colonne de sortie est type, spécifiez "type" pour l’identificateur.

Exemples¶

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

SHOW OFFERS LIKE 'MYOFFER%' IN LISTING MYLISTING;

Copy