

 Amazon Redshift ne prendra plus en charge la création de nouveaux Python à UDFs partir du patch 198. UDFs Le Python existant continuera de fonctionner jusqu'au 30 juin 2026. Pour plus d’informations, consultez le [ billet de blog ](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). 

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Fonction de fenêtrage RATIO\$1TO\$1REPORT
<a name="r_WF_RATIO_TO_REPORT"></a>

Calcule le ratio d’une valeur par rapport à la somme des valeurs dans une fenêtre ou une partition. La valeur de RATIO TO REPORT est déterminée à l’aide de la formule suivante :

`value of `*ratio\$1expression* `argument for the current row / sum of` *ratio\$1expression* `argument for the window or partition`

Le jeu de données suivant illustre l’utilisation de cette formule :

```
Row#	Value	Calculation	RATIO_TO_REPORT
1	2500	(2500)/(13900)	0.1798
2	2600	(2600)/(13900)	0.1870
3	2800	(2800)/(13900)	0.2014
4	2900	(2900)/(13900)	0.2086
5	3100	(3100)/(13900)	0.2230
```

La plage de valeur de retour est comprise entre 0 et 1, inclus. Si *ratio\$1expression* a la valeur NULL, la valeur renvoyée est `NULL`. Si une valeur dans *partition\$1expression* est unique, la fonction retournera `1` pour cette valeur.

## Syntaxe
<a name="r_WF_RATIO_TO_REPORT-synopsis"></a>

```
RATIO_TO_REPORT ( ratio_expression )
OVER ( [ PARTITION BY partition_expression ] )
```

## Arguments
<a name="r_WF_RATIO_TO_REPORT-arguments"></a>

*ratio\$1expression*   
Expression, comme un nom de colonne, qui fournit la valeur pour laquelle déterminer le ratio. L’expression doit disposer d’un type de données numériques ou être convertible implicitement en une.  
Vous ne pouvez pas utiliser d’autre fonction analytique dans *ratio\$1expression*.

OVER  
Clause qui spécifie le partitionnement de fenêtrage. La clause OVER ne peut pas contenir d’ordre de fenêtrage ou de spécification de cadre de fenêtrage.

PARTITION BY *partition\$1expression*   
Facultatif. Expression qui définit la plage d’enregistrements de chaque groupe dans la clause OVER.

## Type de retour
<a name="r_WF_RATIO_TO_REPORT-return-type"></a>

FLOAT8

## Exemples
<a name="r_WF_RATIO_TO_REPORT-examples"></a>

Les exemples suivants utilisent la table WINSALES. Pour en savoir plus sur la façon de créer la table WINSALES, consultez [Exemple de tableau contenant des exemples de fonctions de fenêtrage](c_Window_functions.md#r_Window_function_example).

L'exemple suivant calcule la ratio-to-report valeur de chaque ligne de la quantité d'un vendeur par rapport au total de toutes les quantités du vendeur.

```
select sellerid, qty, ratio_to_report(qty) 
over()
from winsales
order by sellerid;

sellerid  qty    ratio_to_report
--------------------------------------
1         30     0.13953488372093023	
1         10     0.046511627906976744	
1         10     0.046511627906976744	
2         20     0.09302325581395349	
2         20     0.09302325581395349	
3         30     0.13953488372093023	
3         20     0.09302325581395349	
3         15     0.06976744186046512	
3         10     0.046511627906976744	
4         10     0.046511627906976744	
4         40     0.18604651162790697
```

L’exemple suivant calcule les ratios des volumes de ventes de chaque vendeur, par partition.

```
select sellerid, qty, ratio_to_report(qty) 
over(partition by sellerid) 
from winsales;

sellerid   qty    ratio_to_report
-------------------------------------------
2          20     0.5	
2          20     0.5	
4          40     0.8	
4          10     0.2	
1          10     0.2	
1          30     0.6	
1          10     0.2	
3          10     0.13333333333333333	
3          15     0.2	
3          20     0.26666666666666666	
3          30     0.4
```