Categorias:: Funções de agregação (Geral) , Sintaxe e uso da função de janela (Geral)

STDDEV, STDDEV_SAMP¶

Retorna o desvio padrão da amostra (raiz quadrada da variância da amostra) de valores não NULL. STDDEV e STDDEV_SAMP são aliases para a mesma função.

Consulte também STDDEV_POP, que retorna o desvio padrão da população (raiz quadrada da variância).

Sintaxe¶

Função de agregação

{ STDDEV | STDDEV_SAMP } ( [ DISTINCT ] <expr1> )

Função de janela

{ STDDEV | STDDEV_SAMP } ( [ DISTINCT ] <expr1> ) OVER (
                                                       [ PARTITION BY <expr2> ]
                                                       [ ORDER BY <expr3> [ { ASC | DESC } ] [ NULLS { FIRST | LAST } ] [ <window_frame> ] ]
                                                       )

Para obter mais detalhes sobre a sintaxe window_frame, consulte Notas de uso para quadros de janela.

Argumentos¶

expr1: Uma expressão que é avaliada como um valor numérico. Esta é a expressão na qual é calculado o desvio padrão.
expr2: Esta é a expressão opcional para divisão.
expr3: Esta é a expressão opcional a ordenar dentro de cada partição.

Retornos¶

O tipo de dados do valor retornado é DOUBLE.

Se todos os registros dentro de um grupo forem NULL, esta função retorna NULL.

Notas de uso¶

Para entradas de registro único, STDDEV e STDDEV_SAMP retornam NULL. Isto é diferente do comportamento do Oracle, onde STDDEV_SAMP retorna NULL para um único registro e STDDEV retorna 0.
Ao passar uma expressão VARCHAR, esta função converte implicitamente a entrada em valores de ponto flutuante. Se a conversão não puder ser executada, um erro é devolvido.
Quando esta função é chamada como uma função de janela e a cláusula OVER contém uma cláusula ORDER BY:
- A palavra-chave DISTINCT é proibida e resulta em um erro de compilação SQL.
- Um quadro de janela deve ser especificado. Se você não especificar uma quadro de janela, o seguinte quadro de janela implícito será usado:
  
  RANGE BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW
Para obter mais detalhes sobre quadros de janela, incluindo sintaxe e exemplos, consulte Notas de uso para quadros de janela.

Exemplos de funções de agregação¶

O exemplo a seguir calcula o desvio padrão para uma pequena amostra de números inteiros:

CREATE TABLE t1 (c1 INTEGER);
INSERT INTO t1 (c1) VALUES
  (6),
  (10),
  (14);
SELECT STDDEV(c1) FROM t1;

+----------+
| STDDEV() |
|----------|
|        4 |
+----------+

Observe que a função STDDEV_SAMP retorna o mesmo resultado:

SELECT STDDEV_SAMP(c1) FROM t1;

+-----------------+
| STDDEV_SAMP(C1) |
|-----------------|
|               4 |
+-----------------+

O exemplo a seguir usa uma pequena tabela chamada menu_items, que lista os itens à venda em um food truck. Se desejar criar e carregar esta tabela, consulte Criação e carregamento da tabela menu_items.

Para encontrar o desvio padrão da amostra para o custo dos produtos vendidos (COGS) e o preço de venda para as linhas Dessert, execute esta consulta:

SELECT menu_category, STDDEV(menu_cogs_usd) AS stddev_cogs, STDDEV(menu_price_usd) AS stddev_price
  FROM menu_items
  WHERE menu_category = 'Dessert'
  GROUP BY 1;

+---------------+-------------+--------------+
| MENU_CATEGORY | STDDEV_COGS | STDDEV_PRICE |
|---------------+-------------+--------------|
| Dessert       |  1.00519484 |  1.471960144 |
+---------------+-------------+--------------+

Exemplo de função de janela¶

O exemplo a seguir também usa a tabela menu_items (consulte Criação e carregamento da tabela menu_items), mas chama a função STDDEV como uma função de janela.

A função de janela particiona linhas pela coluna menu_category. Portanto, o desvio padrão é calculado uma vez para cada categoria, e esse valor é repetido no resultado para cada linha do grupo. Neste exemplo, as linhas devem ser agrupadas pela categoria do menu e pelo custo dos produtos vendidos.

SELECT menu_category, menu_cogs_usd,
  STDDEV(menu_cogs_usd) OVER(PARTITION BY menu_category) AS stddev_cogs
  FROM menu_items
  GROUP BY 1, 2
  ORDER BY menu_category;

A saída a seguir é um conjunto de resultados parciais para esta consulta (as primeiras 15 linhas):

+---------------+---------------+--------------+
| MENU_CATEGORY | MENU_COGS_USD |  STDDEV_COGS |
|---------------+---------------+--------------|
| Beverage      |          0.50 | 0.1258305738 |
| Beverage      |          0.65 | 0.1258305738 |
| Beverage      |          0.75 | 0.1258305738 |
| Dessert       |          1.25 | 1.054751155  |
| Dessert       |          3.00 | 1.054751155  |
| Dessert       |          1.00 | 1.054751155  |
| Dessert       |          2.50 | 1.054751155  |
| Dessert       |          0.50 | 1.054751155  |
| Main          |          4.50 | 3.444051572  |
| Main          |          2.40 | 3.444051572  |
| Main          |          1.50 | 3.444051572  |
| Main          |         11.00 | 3.444051572  |
| Main          |          8.00 | 3.444051572  |
| Main          |          NULL | 3.444051572  |
| Main          |         12.00 | 3.444051572  |
...

Criação e carregamento da tabela menu_items¶

Para criar e inserir linhas na tabela menu_items usada em alguns exemplos de funções, execute os comandos SQL a seguir. (Esta tabela contém 60 linhas. Ela se baseia, mas não é idêntica, à tabela menu no banco de dados de amostra Tasty Bytes.)

CREATE OR REPLACE TABLE menu_items(
  menu_id INT NOT NULL,
  menu_category VARCHAR(20),
  menu_item_name VARCHAR(50),
  menu_cogs_usd NUMBER(7,2),
  menu_price_usd NUMBER(7,2));

INSERT INTO menu_items VALUES(1,'Beverage','Bottled Soda',0.500,3.00);
INSERT INTO menu_items VALUES(2,'Beverage','Bottled Water',0.500,2.00);
INSERT INTO menu_items VALUES(3,'Main','Breakfast Crepe',5.00,12.00);
INSERT INTO menu_items VALUES(4,'Main','Buffalo Mac & Cheese',6.00,10.00);
INSERT INTO menu_items VALUES(5,'Main','Chicago Dog',4.00,9.00);
INSERT INTO menu_items VALUES(6,'Main','Chicken Burrito',3.2500,12.500);
INSERT INTO menu_items VALUES(7,'Main','Chicken Pot Pie Crepe',6.00,15.00);
INSERT INTO menu_items VALUES(8,'Main','Combination Curry',9.00,15.00);
INSERT INTO menu_items VALUES(9,'Main','Combo Fried Rice',5.00,11.00);
INSERT INTO menu_items VALUES(10,'Main','Combo Lo Mein',6.00,13.00);
INSERT INTO menu_items VALUES(11,'Main','Coney Dog',5.00,10.00);
INSERT INTO menu_items VALUES(12,'Main','Creamy Chicken Ramen',8.00,17.2500);
INSERT INTO menu_items VALUES(13,'Snack','Crepe Suzette',4.00,9.00);
INSERT INTO menu_items VALUES(14,'Main','Fish Burrito',3.7500,12.500);
INSERT INTO menu_items VALUES(15,'Snack','Fried Pickles',1.2500,6.00);
INSERT INTO menu_items VALUES(16,'Snack','Greek Salad',4.00,11.00);
INSERT INTO menu_items VALUES(17,'Main','Gyro Plate',8.00,12.00);
INSERT INTO menu_items VALUES(18,'Main','Hot Ham & Cheese',7.00,11.00);
INSERT INTO menu_items VALUES(19,'Dessert','Ice Cream Sandwich',1.00,4.00);
INSERT INTO menu_items VALUES(20,'Beverage','Iced Tea',0.7500,3.00);
INSERT INTO menu_items VALUES(21,'Main','Italian',6.00,11.00);
INSERT INTO menu_items VALUES(22,'Main','Lean Beef Tibs',6.00,13.00);
INSERT INTO menu_items VALUES(23,'Main','Lean Burrito Bowl',3.500,12.500);
INSERT INTO menu_items VALUES(24,'Main','Lean Chicken Tibs',5.00,11.00);
INSERT INTO menu_items VALUES(25,'Main','Lean Chicken Tikka Masala',10.00,17.00);
INSERT INTO menu_items VALUES(26,'Beverage','Lemonade',0.6500,3.500);
INSERT INTO menu_items VALUES(27,'Main','Lobster Mac & Cheese',10.00,15.00);
INSERT INTO menu_items VALUES(28,'Dessert','Mango Sticky Rice',1.2500,5.00);
INSERT INTO menu_items VALUES(29,'Main','Miss Piggie',2.600,6.00);
INSERT INTO menu_items VALUES(30,'Main','Mothers Favorite',4.500,12.00);
INSERT INTO menu_items VALUES(31,'Main','New York Dog',4.00,8.00);
INSERT INTO menu_items VALUES(32,'Main','Pastrami',8.00,11.00);
INSERT INTO menu_items VALUES(33,'Dessert','Popsicle',0.500,3.00);
INSERT INTO menu_items VALUES(34,'Main','Pulled Pork Sandwich',7.00,12.00);
INSERT INTO menu_items VALUES(35,'Main','Rack of Pork Ribs',11.2500,21.00);
INSERT INTO menu_items VALUES(36,'Snack','Seitan Buffalo Wings',4.00,7.00);
INSERT INTO menu_items VALUES(37,'Main','Spicy Miso Vegetable Ramen',7.00,17.2500);
INSERT INTO menu_items VALUES(38,'Snack','Spring Mix Salad',2.2500,6.00);
INSERT INTO menu_items VALUES(39,'Main','Standard Mac & Cheese',3.00,8.00);
INSERT INTO menu_items VALUES(40,'Dessert','Sugar Cone',2.500,6.00);
INSERT INTO menu_items VALUES(41,'Main','Tandoori Mixed Grill',11.00,18.00);
INSERT INTO menu_items VALUES(42,'Main','The Classic',4.00,12.00);
INSERT INTO menu_items VALUES(43,'Main','The King Combo',12.00,20.00);
INSERT INTO menu_items VALUES(44,'Main','The Kitchen Sink',6.00,14.00);
INSERT INTO menu_items VALUES(45,'Main','The Original',1.500,5.00);
INSERT INTO menu_items VALUES(46,'Main','The Ranch',2.400,6.00);
INSERT INTO menu_items VALUES(47,'Main','The Salad of All Salads',6.00,12.00);
INSERT INTO menu_items VALUES(48,'Main','Three Meat Plate',10.00,17.00);
INSERT INTO menu_items VALUES(49,'Main','Three Taco Combo Plate',7.00,11.00);
INSERT INTO menu_items VALUES(50,'Main','Tonkotsu Ramen',7.00,17.2500);
INSERT INTO menu_items VALUES(51,'Main','Two Meat Plate',9.00,14.00);
INSERT INTO menu_items VALUES(52,'Dessert','Two Scoop Bowl',3.00,7.00);
INSERT INTO menu_items VALUES(53,'Main','Two Taco Combo Plate',6.00,9.00);
INSERT INTO menu_items VALUES(54,'Main','Veggie Burger',5.00,9.00);
INSERT INTO menu_items VALUES(55,'Main','Veggie Combo',4.00,9.00);
INSERT INTO menu_items VALUES(56,'Main','Veggie Taco Bowl',6.00,10.00);
INSERT INTO menu_items VALUES(57,'Dessert','Waffle Cone',2.500,6.00);
INSERT INTO menu_items VALUES(58,'Main','Wonton Soup',2.00,6.00);
INSERT INTO menu_items VALUES(59,'Main','Mini Pizza',null,null);
INSERT INTO menu_items VALUES(60,'Main','Large Pizza',null,null);