xqlsystems/xarray-sql

O que é?

Recursos principais

• 01Registra Xarray Datasets como tabelas SQL com from_dataset ou xql.register.
• 02Converte os resultados das consultas de volta em Xarray Datasets com to_dataset.
• 03Funciona com DuckDB, Polars, DataFusion e qualquer banco de dados compatível com ADBC.
• 04Aplica pushdown de projeção de colunas e filtros de dimensão em Zarr, além de poda de partições.
• 05Disponibiliza datasets por Arrow Flight SQL para clientes externos.

Casos de uso

• Executar agregações SQL, como climatologias mensais, em dados meteorológicos ou climáticos em grade.
• Combinar dados tabulares com datasets raster ou em grade usando SQL.
• Consultar grandes datasets Zarr hospedados na nuvem sem carregá-los inteiramente na memória.
• Permitir que usuários de SQL acessem dados científicos de arrays por meio de ferramentas de banco de dados conhecidas.

Início rápido

1. 1

   Instale a biblioteca pelo PyPI

   pip install xarray-sql
2. 2

   Instale as dependências opcionais para o exemplo do tutorial (pooch, netCDF4, matplotlib)

   pip install pooch netCDF4 matplotlib

Antes de usar

• !O projeto ainda está em estágio inicial; os mantenedores estão buscando usuários pioneiros e ele pode mudar.
• !Alguns problemas conhecidos específicos de cada engine e problemas fundamentais estão documentados separadamente; consulte-os antes de depender do projeto.
• !Operações com tensores densos são mais lentas em SQL do que no Xarray nativo.

Em coleções

Tópicos

Perguntas frequentes

O que é xarray-sql?

Biblioteca Python que permite consultar datasets do Xarray com SQL, tratando dados de arrays como tabelas e usando DuckDB, Polars, DataFusion ou engines ADBC. xarray-sql oferece uma interface SQL para datasets de arrays. Ele transforma Xarray Datasets em tabelas para que consultas SQL possam ser executadas neles usando a engine de consulta que você escolher. Um dataset é registrado como tabela com from_dataset, consultado com SQL padrão e, em seguida, o resultado pode ser convertido de volta em um Xarray Dataset para análises ou visualizações adicionais.

xarray-sql é gratuito? Qual é a licença?

xarray-sql é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.

xarray-sql ainda é mantido?

Manutenção ativa. O último commit de xarray-sql foi em 2 de nov. de 2026.

Para que posso usar xarray-sql?

Executar agregações SQL, como climatologias mensais, em dados meteorológicos ou climáticos em grade. Combinar dados tabulares com datasets raster ou em grade usando SQL. Consultar grandes datasets Zarr hospedados na nuvem sem carregá-los inteiramente na memória. Permitir que usuários de SQL acessem dados científicos de arrays por meio de ferramentas de banco de dados conhecidas.

Como instalar xarray-sql?

Instale a biblioteca pelo PyPI: pip install xarray-sql Instale as dependências opcionais para o exemplo do tutorial (pooch, netCDF4, matplotlib): pip install pooch netCDF4 matplotlib

Onde consigo xarray-sql?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/xqlsystems/xarray-sql