Informations de référence sur la table système de prix

Cet article fournit une vue d’ensemble de la table système de prix. Sont inclus le schéma et des exemples de requêtes. La table de prix vous donne accès à un journal historique des prix des références SKU. Un enregistrement est ajouté chaque fois que le prix d’une référence SKU change. Ces journaux peuvent vous aider à effectuer une analyse des coûts et à surveiller les changements de prix.

Chemin d’accès de la table : cette table système se trouve à l’emplacement system.billing.list_prices.

Schéma de la table de prix

La table système de prix utilise le schéma suivant :

Nom de la colonne	Type de données	Description	Exemple
price_start_time	timestamp	Date à laquelle ce prix est entré en vigueur en UTC	2023-01-01T09:59:59.999Z
price_end_time	timestamp	Date à laquelle ce prix a cessé d’être en vigueur en UTC	2023-01-01T09:59:59.999Z
account_id	string	ID du compte pour lequel ce rapport a été généré	1234567890123456
sku_name	string	Nom du SKU	STANDARD_ALL_PURPOSE_COMPUTE
cloud	string	Nom du cloud auquel ce prix s’applique. Les valeurs possibles sont AWS, AZURE et GCP.	AWS, AZURE ou GCP
currency_code	string	Devise dans laquelle ce prix est exprimé.	USD
usage_unit	string	Unité de mesure monétisée.	DBU
pricing	struct	Champ de données structuré qui inclut des informations sur les prix au tarif catalogue publié. La clé default retourne toujours un prix unique qui peut être utilisé pour des estimations à long terme simples. La clé promotional représente un prix promotionnel temporaire que tous les clients obtiennent et qui peut être utilisé pour l’estimation des coûts pendant la période temporaire. La clé effective_list résout le prix catalogue et le prix promotionnel, et contient le prix catalogue effectif utilisé pour calculer le coût. Certains modèles de prix peuvent inclure des clés supplémentaires qui fournissent plus de détails.	{ "default": "0.10", "promotional": {"default": "0.07"}, "effective_list": {"default": "0.07"} }

Exemples de requêtes

Vous pouvez utiliser les exemples de requêtes suivants pour répondre aux questions courantes sur les prix des références SKU :

• Rechercher le prix catalogue d’une référence SKU particulière à une date donnée
• Afficher le coût total de tous les éléments ayant utilisé une étiquette personnalisée particulière au cours du mois civil précédent
• Afficher les prix qui ont changé d’un mois à un autre
• Estimer les coûts d’utilisation du module complémentaire lors du mois calendaire précédent

Pour obtenir des exemples de requêtes concernant l’observabilité des coûts de travail, consultez Surveiller les coûts des travaux avec les tables système.

Rechercher le prix catalogue d’une référence SKU particulière à une date donnée

Étant donné que la table contient uniquement des enregistrements indiquant la date du changement de prix d’une référence SKU, vous devez rechercher le changement de prix le plus récent au plus tard à cette date.

SELECT sku_name, price_start_time, pricing.default
FROM system.billing.list_prices
WHERE sku_name = 'STANDARD_ALL_PURPOSE_COMPUTE'
AND price_start_time <= "2023-01-01"
ORDER BY price_start_time DESC
LIMIT 1

Afficher le coût total de tous les éléments ayant utilisé une étiquette personnalisée particulière au cours du mois civil précédent

Remarque

Assurez-vous de remplacer la clé et la valeur de la balise personnalisée.

SELECT
 SUM(usage.usage_quantity * list_prices.pricing.effective_list.default)
 as `Total Dollar Cost`
FROM system.billing.usage
JOIN system.billing.list_prices ON list_prices.sku_name = usage.sku_name
WHERE usage.custom_tags.{{ tag_key }} = {{ tag_value }}
AND usage.usage_end_time >= list_prices.price_start_time
AND (list_prices.price_end_time IS NULL OR usage.usage_end_time < list_prices.price_end_time)
AND usage.usage_date BETWEEN "2023-05-01" AND "2023-05-31"

Afficher les prix qui ont changé d’un mois à un autre

SELECT sku_name, price_start_time, pricing.default
FROM system.billing.list_prices
WHERE price_start_time BETWEEN "2023-05-01" AND "2023-07-01"

Estimer les coûts d’utilisation du module complémentaire lors du mois calendaire précédent

Cette requête applique un pourcentage simple à toutes les utilisations durant la période. Remarquez que cela peut légèrement différer de la monétisation réelle en raison du mode de gestion des droits d’utilisation pour certains modules complémentaires. Remplacez le taux du module complémentaire par le taux de votre compte.

SELECT SUM(usage.usage_quantity * list_prices.pricing.effective_list.default) * {{ add_on_rate }} as `Total Add-On Dollar Cost`
FROM system.billing.usage
JOIN system.billing.list_prices ON list_prices.sku_name = usage.sku_name
  WHERE usage.usage_end_time >= list_prices.price_start_time
  AND (list_prices.price_end_time IS NULL OR usage.usage_end_time < list_prices.price_end_time)
  AND usage.usage_date BETWEEN "2024-02-01" AND "2024-02-29"