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
truesi l'enregistrement est échantillonné ; renvoiefalsedans le cas contraire.La probabilité d'échantillonnage est contrôlée par
sample_rate.La valeur de retour dépend à la fois de
tupleet desample_rate.Lorsqu'elle est appliquée à tous les enregistrements d'une table,
tupledoit être unique pour chaque enregistrement. Cela garantit que le nombre d'enregistrements échantillonnés se rapproche desample_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));