Tous les produits
Search
Centre de documentation

PolarDB:ST_IsRandomSampled

Dernière mise à jour :Sep 02, 2026

Vérifie si un enregistrement est échantillonné en fonction de sa valeur de hachage et du taux d'échantillonnage spécifié. Renvoie true si l'enregistrement est échantillonné, false dans le cas contraire. La probabilité d'échantillonnage correspond à la valeur de sample_rate.

Syntaxe

BOOLEAN ST_IsRandomSampled(RECORD tuple, INTEGER sample_rate)

Paramètres

Paramètre Description
tuple Les propriétés de l'enregistrement utilisées pour générer la valeur de hachage. Le système détermine s'il faut échantillonner un enregistrement sur la base de ce hachage. Utilisez ROW() pour construire un hachage à partir de plusieurs propriétés. Pour obtenir des ratios d'échantillonnage précis sur une table, sélectionnez des propriétés ou des combinaisons de propriétés qui sont uniques et uniformément distribuées.
sample_rate La probabilité d'échantillonnage, exprimée sous forme de pourcentage entier. Par exemple, une valeur de 50 signifie que chaque enregistrement a 50 % de chances d'être échantillonné.

Description

  • Renvoie true si l'enregistrement est échantillonné ; renvoie false dans le cas contraire.

  • La probabilité d'échantillonnage est contrôlée par sample_rate.

  • La valeur de retour dépend à la fois de tuple et de sample_rate.

  • Lorsqu'elle est appliquée à tous les enregistrements d'une table, tuple doit être unique pour chaque enregistrement. Cela garantit que le nombre d'enregistrements échantillonnés se rapproche de sample_rate × le nombre total d'enregistrements.

Exemples

-- Return results for all records. true is returned for half of the records, and false for the other half.
SELECT ST_IsRandomSampled(ROW(id), 50) FROM table;

-- Calculate the area of geometries that have an 80% probability of being sampled.
SELECT ST_Area(geom) FROM table WHERE ST_IsRandomSampled(ROW(geom), 80);

-- Randomly select half of the geometries and convert them to MVTGeom objects.
SELECT ST_AsMVTGeom(geom, ST_Transform(ST_TileEnvelope(0,0,0),4326)) FROM table
WHERE ST_IsRandomSampled(ROW(geom), 50) AND geom&&ST_Transform(ST_TileEnvelope(0,0,0),4326));