import polars as pl
# Criando DataFrames
clientes = pl.DataFrame({
"cliente_id": [1, 2, 3, 4],
"nome": ["Ana", "Bruno", "Clara", "Daniel"]
})
print(clientes)shape: (4, 2)
┌────────────┬────────┐
│ cliente_id ┆ nome │
│ --- ┆ --- │
│ i64 ┆ str │
╞════════════╪════════╡
│ 1 ┆ Ana │
│ 2 ┆ Bruno │
│ 3 ┆ Clara │
│ 4 ┆ Daniel │
└────────────┴────────┘pedidos = pl.DataFrame({
"pedido_id": [101, 102, 103, 104, 105],
"cliente_id": [1, 2, 3, 1, 5],
"valor": [100.50, 250.75, 75.00, 130.00, 79.00]
})
print(pedidos)shape: (5, 3)
┌───────────┬────────────┬────────┐
│ pedido_id ┆ cliente_id ┆ valor │
│ --- ┆ --- ┆ --- │
│ i64 ┆ i64 ┆ f64 │
╞═══════════╪════════════╪════════╡
│ 101 ┆ 1 ┆ 100.5 │
│ 102 ┆ 2 ┆ 250.75 │
│ 103 ┆ 3 ┆ 75.0 │
│ 104 ┆ 1 ┆ 130.0 │
│ 105 ┆ 5 ┆ 79.0 │
└───────────┴────────────┴────────┘JOIN combina registros de duas tabelas com base em uma coluna comum (chave).INNER JOINRetorna apenas as linhas que têm correspondências (de chaves) nas duas tabelas.
INNER JOINshape: (4, 4)
┌────────────┬───────┬───────────┬────────┐
│ cliente_id ┆ nome ┆ pedido_id ┆ valor │
│ --- ┆ --- ┆ --- ┆ --- │
│ i64 ┆ str ┆ i64 ┆ f64 │
╞════════════╪═══════╪═══════════╪════════╡
│ 1 ┆ Ana ┆ 101 ┆ 100.5 │
│ 2 ┆ Bruno ┆ 102 ┆ 250.75 │
│ 3 ┆ Clara ┆ 103 ┆ 75.0 │
│ 1 ┆ Ana ┆ 104 ┆ 130.0 │
└────────────┴───────┴───────────┴────────┘LEFT/RIGHT JOINRetorna todas as linhas da tabela à esquerda [direita] e as correspondentes da direita [esquerda] (se houver).
LEFT JOINshape: (5, 4)
┌────────────┬────────┬───────────┬────────┐
│ cliente_id ┆ nome ┆ pedido_id ┆ valor │
│ --- ┆ --- ┆ --- ┆ --- │
│ i64 ┆ str ┆ i64 ┆ f64 │
╞════════════╪════════╪═══════════╪════════╡
│ 1 ┆ Ana ┆ 101 ┆ 100.5 │
│ 1 ┆ Ana ┆ 104 ┆ 130.0 │
│ 2 ┆ Bruno ┆ 102 ┆ 250.75 │
│ 3 ┆ Clara ┆ 103 ┆ 75.0 │
│ 4 ┆ Daniel ┆ null ┆ null │
└────────────┴────────┴───────────┴────────┘RIGHT JOINshape: (5, 4)
┌───────┬───────────┬────────────┬────────┐
│ nome ┆ pedido_id ┆ cliente_id ┆ valor │
│ --- ┆ --- ┆ --- ┆ --- │
│ str ┆ i64 ┆ i64 ┆ f64 │
╞═══════╪═══════════╪════════════╪════════╡
│ Ana ┆ 101 ┆ 1 ┆ 100.5 │
│ Bruno ┆ 102 ┆ 2 ┆ 250.75 │
│ Clara ┆ 103 ┆ 3 ┆ 75.0 │
│ Ana ┆ 104 ┆ 1 ┆ 130.0 │
│ null ┆ 105 ┆ 5 ┆ 79.0 │
└───────┴───────────┴────────────┴────────┘OUTER JOINRetorna todas as linhas quando há uma correspondência em uma das tabelas.
OUTER JOINshape: (6, 5)
┌────────────┬────────┬───────────┬──────────────────┬────────┐
│ cliente_id ┆ nome ┆ pedido_id ┆ cliente_id_right ┆ valor │
│ --- ┆ --- ┆ --- ┆ --- ┆ --- │
│ i64 ┆ str ┆ i64 ┆ i64 ┆ f64 │
╞════════════╪════════╪═══════════╪══════════════════╪════════╡
│ 1 ┆ Ana ┆ 101 ┆ 1 ┆ 100.5 │
│ 2 ┆ Bruno ┆ 102 ┆ 2 ┆ 250.75 │
│ 3 ┆ Clara ┆ 103 ┆ 3 ┆ 75.0 │
│ 1 ┆ Ana ┆ 104 ┆ 1 ┆ 130.0 │
│ null ┆ null ┆ 105 ┆ 5 ┆ 79.0 │
│ 4 ┆ Daniel ┆ null ┆ null ┆ null │
└────────────┴────────┴───────────┴──────────────────┴────────┘CROSS JOINRetorna o produto cartesiano de ambas as tabelas.
CROSS JOINshape: (20, 5)
┌────────────┬────────┬───────────┬──────────────────┬────────┐
│ cliente_id ┆ nome ┆ pedido_id ┆ cliente_id_right ┆ valor │
│ --- ┆ --- ┆ --- ┆ --- ┆ --- │
│ i64 ┆ str ┆ i64 ┆ i64 ┆ f64 │
╞════════════╪════════╪═══════════╪══════════════════╪════════╡
│ 1 ┆ Ana ┆ 101 ┆ 1 ┆ 100.5 │
│ 1 ┆ Ana ┆ 102 ┆ 2 ┆ 250.75 │
│ 1 ┆ Ana ┆ 103 ┆ 3 ┆ 75.0 │
│ 1 ┆ Ana ┆ 104 ┆ 1 ┆ 130.0 │
│ 1 ┆ Ana ┆ 105 ┆ 5 ┆ 79.0 │
│ … ┆ … ┆ … ┆ … ┆ … │
│ 4 ┆ Daniel ┆ 101 ┆ 1 ┆ 100.5 │
│ 4 ┆ Daniel ┆ 102 ┆ 2 ┆ 250.75 │
│ 4 ┆ Daniel ┆ 103 ┆ 3 ┆ 75.0 │
│ 4 ┆ Daniel ┆ 104 ┆ 1 ┆ 130.0 │
│ 4 ┆ Daniel ┆ 105 ┆ 5 ┆ 79.0 │
└────────────┴────────┴───────────┴──────────────────┴────────┘JOIN, a tabela resultante continua sendo um DataFrame.DataFrame podem ser aplicadas:
shape: (5, 3)
┌───────────┬────────────┬────────┐
│ pedido_id ┆ cliente_id ┆ valor │
│ --- ┆ --- ┆ --- │
│ i64 ┆ i64 ┆ f64 │
╞═══════════╪════════════╪════════╡
│ 101 ┆ 1 ┆ 100.5 │
│ 102 ┆ 2 ┆ 250.75 │
│ 103 ┆ 3 ┆ 75.0 │
│ 104 ┆ 1 ┆ 130.0 │
│ 105 ┆ 5 ┆ 79.0 │
└───────────┴────────────┴────────┘shape: (3, 3)
┌───────┬────────────┬────────┐
│ nome ┆ cliente_id ┆ valor │
│ --- ┆ --- ┆ --- │
│ str ┆ i64 ┆ f64 │
╞═══════╪════════════╪════════╡
│ Clara ┆ 3 ┆ 75.0 │
│ Ana ┆ 1 ┆ 115.25 │
│ Bruno ┆ 2 ┆ 250.75 │
└───────┴────────────┴────────┘shape: (5, 3)
┌───────────┬────────────┬────────┐
│ pedido_id ┆ cliente_id ┆ valor │
│ --- ┆ --- ┆ --- │
│ i64 ┆ i64 ┆ f64 │
╞═══════════╪════════════╪════════╡
│ 101 ┆ 1 ┆ 100.5 │
│ 102 ┆ 2 ┆ 250.75 │
│ 103 ┆ 3 ┆ 75.0 │
│ 104 ┆ 1 ┆ 130.0 │
│ 105 ┆ 5 ┆ 79.0 │
└───────────┴────────────┴────────┘JOIN com Múltiplas Colunas como Chaveshape: (3, 4)
┌────────┬───────┬─────────┬───────┐
│ id_ped ┆ cl_id ┆ id_prod ┆ valor │
│ --- ┆ --- ┆ --- ┆ --- │
│ i64 ┆ i64 ┆ i64 ┆ f64 │
╞════════╪═══════╪═════════╪═══════╡
│ 201 ┆ 1 ┆ 101 ┆ 50.0 │
│ 202 ┆ 2 ┆ 102 ┆ 75.0 │
│ 203 ┆ 1 ┆ 104 ┆ 100.0 │
└────────┴───────┴─────────┴───────┘JOIN com Múltiplas Colunasfinal = vendas.join(detalhes_pedidos,
left_on = ["id_cl", "id_prod"],
right_on = ["cl_id", "id_prod"],
how = "inner")
print(final)shape: (2, 6)
┌──────────┬───────┬─────────┬──────┬────────┬───────┐
│ id_venda ┆ id_cl ┆ id_prod ┆ qtde ┆ id_ped ┆ valor │
│ --- ┆ --- ┆ --- ┆ --- ┆ --- ┆ --- │
│ i64 ┆ i64 ┆ i64 ┆ i64 ┆ i64 ┆ f64 │
╞══════════╪═══════╪═════════╪══════╪════════╪═══════╡
│ 1 ┆ 1 ┆ 101 ┆ 2 ┆ 201 ┆ 50.0 │
│ 2 ┆ 2 ┆ 102 ┆ 1 ┆ 202 ┆ 75.0 │
└──────────┴───────┴─────────┴──────┴────────┴───────┘