Cotação do Dólar

DIMENSÃOATIVODIÁRIO

Tabela dimensão que contém o histórico de cotações do Dólar Americano (USD) em relação ao Real Brasileiro (BRL), extraído da API oficial PTAX do Banco Central do Brasil. Utilizada para conversão de valores em moeda estrangeira e análises financeiras.

---

Informações Gerais

Nome Técnicodim_cotacao_dolar

Nome de NegócioCotação do Dólar

LakehouseLH_Corp_Gold

OwnerTime de Dados

FrequênciaDiária

Horário de Atualização07:00

SLADisponível até 07:30

ClassificaçãoPúblico

---

Linhagem de Dados

FONTE

API PTAX — Banco Central do Brasil

Endpoint: CotacaoDolarDia / CotacaoDolarPeriodo | REST API | ~1 registro/dia útil

↓

BRONZE

LH_Corp_Bronze.dbo.raw_api_cotacao_dolar

Dados brutos da API + metadados (dt_carga, origem)

NotebookNB_Bronze_Cotacao_Dolar

↓

⚙️

Transformações Bronze → Silver

Conversão tiposExtração data_cotacaoCálculo valor_medioDeduplicação por data

NotebookNB_Silver_Cotacao_Dolar

↓

SILVER

LH_Corp_Silver.dbo.cotacao_dolar

Dados limpos, tipados e deduplicados

↓

⚙️

Transformações Silver → Gold

Surrogate keyCampos derivados (ano, mes, dia)Tradução dia_semana

NotebookNB_Gold_Cotacao_Dolar

↓

GOLD

LH_Corp_Gold.dbo.dim_cotacao_dolar

Dimensão final pronta para consumo

Registros~250/ano

↓

SM_Financeiro_Geral

SM_Comercial_Geral

---

Dicionário de Dados

Chaves

🔑 Chave Primária (Surrogate)sk_cotacao

🏷️ Chave de Negóciodata_cotacao

Colunas

Coluna	Tipo	Descrição	Origem
sk_cotacao	BIGINT	Surrogate key gerada	Gerado (monotonically_increasing_id)
data_cotacao	DATE	Data da cotação (chave de negócio)	Derivado de data_hora_cotacao
data_hora_cotacao	TIMESTAMP	Data e hora exata da cotação	API: dataHoraCotacao
moeda_origem	STRING	Código da moeda de origem	Fixo: "USD"
moeda_destino	STRING	Código da moeda de destino	Fixo: "BRL"
valor_compra	DOUBLE	Cotação de compra (bid)	API: cotacaoCompra
valor_venda	DOUBLE	Cotação de venda (ask)	API: cotacaoVenda
valor_medio	DOUBLE	Média entre compra e venda	Calculado: (valor_compra + valor_venda) / 2
tipo_boletim	STRING	Tipo do boletim (Abertura, Fechamento)	API: tipoBoletim
ano	INT	Ano da cotação	Derivado de data_cotacao
mes	INT	Mês da cotação	Derivado de data_cotacao
dia	INT	Dia da cotação	Derivado de data_cotacao
dia_semana	STRING	Nome do dia da semana em português	Derivado e traduzido
dt_carga	TIMESTAMP	Data/hora da ingestão no Bronze	Gerado na ingestão
dt_processamento	TIMESTAMP	Data/hora do processamento Gold	Gerado no processamento

---

Relacionamentos

Fato
fato_vendas_exportacao

←

Dimensão
dim_cotacao_dolar

→

Fato
fato_compras_importacao

Relacionamento via data_cotacao ou sk_cotacao nas tabelas fato.

---

Como Acessar

Power BI

Acesse via Semantic Model no Workspace de produção.

Workspace: QAN_GLB_TD_DATA_PROD

SQL Endpoint

Consulte diretamente via SQL Analytics Endpoint.

SELECT * FROM LH_Corp_Gold.dbo.dim_cotacao_dolar

Notebook PySpark

Carregue a tabela Delta em um DataFrame Spark.

df = spark.table("LH_Corp_Gold.dbo.dim_cotacao_dolar")

🌐API Original (BCB)

Para consultas em tempo real, acesse a API oficial.

olinda.bcb.gov.br/olinda/servico/PTAX

---

Histórico de Alterações

Data	Versão	Alteração	Responsável
2025-01-05	1.0	Criação inicial da dimensão	Time de Dados

---

Dúvidas sobre este asset?

Entre em contato com o Time de Transformação Digital (TD) ou o Comitê de Dados.