[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-75813":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":9,"totalLinesOfCode":9,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":9,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":9,"rankLanguage":9,"license":9,"archived":22,"fork":22,"defaultBranch":23,"hasWiki":22,"hasPages":22,"topics":24,"createdAt":9,"pushedAt":9,"updatedAt":30,"readmeContent":31,"aiSummary":32,"trendingCount":16,"starSnapshotCount":16,"syncStatus":33,"lastSyncTime":34,"discoverSource":35},75813,"polaris","apache\u002Fpolaris","apache","Apache Polaris, the interoperable, open source catalog for Apache Iceberg",null,"https:\u002F\u002Fgithub.com\u002Fapache\u002Fpolaris","Java",1965,459,88,257,0,1,11,28,3,20.99,false,"main",[25,7,5,26,27,28,29],"iceberg","catalog","lakehouse","metadata","opencatalog","2026-06-12 02:03:36","\u003C!--\n  Licensed to the Apache Software Foundation (ASF) under one\n  or more contributor license agreements.  See the NOTICE file\n  distributed with this work for additional information\n  regarding copyright ownership.  The ASF licenses this file\n  to you under the Apache License, Version 2.0 (the\n  \"License\"); you may not use this file except in compliance\n  with the License.  You may obtain a copy of the License at\n\n   http:\u002F\u002Fwww.apache.org\u002Flicenses\u002FLICENSE-2.0\n\n  Unless required by applicable law or agreed to in writing,\n  software distributed under the License is distributed on an\n  \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n  KIND, either express or implied.  See the License for the\n  specific language governing permissions and limitations\n  under the License.\n-->\n\n# Apache Polaris\n\nApache Polaris™ is an open-source, fully-featured catalog for Apache Iceberg™. It implements Iceberg's\n[REST API](https:\u002F\u002Fgithub.com\u002Fapache\u002Ficeberg\u002Fblob\u002Fmain\u002Fopen-api\u002Frest-catalog-open-api.yaml),\nenabling seamless multi-engine interoperability across a wide range of platforms, including Apache Doris™, Apache Flink®,\nApache Spark™, Dremio® OSS, StarRocks, and Trino.\n\nDocumentation is available at https:\u002F\u002Fpolaris.apache.org. The REST OpenAPI specifications can be browsed online:\n[Polaris Management API](https:\u002F\u002Feditor-next.swagger.io\u002F?url=https:\u002F\u002Fraw.githubusercontent.com\u002Fapache\u002Fpolaris\u002Frefs\u002Fheads\u002Fmain\u002Fspec\u002Fpolaris-management-service.yml)\nand [Polaris Catalog API](https:\u002F\u002Feditor-next.swagger.io\u002F?url=https:\u002F\u002Fraw.githubusercontent.com\u002Fapache\u002Fpolaris\u002Frefs\u002Fheads\u002Fmain\u002Fspec\u002Fgenerated\u002Fbundled-polaris-catalog-service.yaml).\n\nFor a high-level, auto-generated tour of the codebase's modules and relationships, see the\n[Code Wiki for Apache Polaris](https:\u002F\u002Fcodewiki.google\u002Fgithub.com\u002Fapache\u002Fpolaris).\nIt is a third-party, auto-generated navigation aid, useful for orientation, but the\nsource tree remains the authoritative reference.\n\nTo get involved, [subscribe to the dev mailing list][dev-list-subscribe] (or browse [the archives](https:\u002F\u002Flists.apache.org\u002Flist.html?dev@polaris.apache.org))\nand read the [CONTRIBUTING guide](CONTRIBUTING.md).\n\n[![Slack](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fchat-on%20Slack-brightgreen.svg?style=for-the-badge)](https:\u002F\u002Fjoin.slack.com\u002Ft\u002Fapache-polaris\u002Fshared_invite\u002Fzt-2y3l3r0fr-VtoW42ltir~nSzCYOrQgfw)\n[![Build Status](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Factions\u002Fworkflow\u002Fstatus\u002Fapache\u002Fpolaris\u002Fci-main.yml?branch=main&label=Main%20CI&logo=Github&style=for-the-badge)](https:\u002F\u002Fgithub.com\u002Fapache\u002Fpolaris\u002Factions\u002Fworkflows\u002Fci-main.yml?query=branch%3Amain)\n\n[dev-list-subscribe]: mailto:dev-subscribe@polaris.apache.org\n\n## Overview & Quickstart\n\n- [Overview](https:\u002F\u002Fpolaris.apache.org\u002Freleases\u002Flatest\u002F) of what Polaris is and how it works.\n- [Quickstart](https:\u002F\u002Fpolaris.apache.org\u002Freleases\u002Flatest\u002Fgetting-started\u002F) to set up a Polaris instance locally or on a supported cloud provider.\n\n## Project Structure\n\nThe repository is organized into the following groups of Gradle modules. Each leaf is a Gradle subproject; some link to a per-module README.\n\n- **Core**\n  - [`polaris-core`](.\u002Fpolaris-core\u002FREADME.md) - entity definitions and core business logic\n- **[API](.\u002Fapi\u002FREADME.md)** - generated from the OpenAPI specifications:\n  - `polaris-api-management-model`, `polaris-api-management-service` - Polaris Management API\n  - `polaris-api-iceberg-service` - Iceberg REST service\n  - `polaris-api-catalog-service` - Polaris Catalog API\n- **Runtime**\n  - [`polaris-server`](.\u002Fruntime\u002Fserver\u002FREADME.md) - Quarkus-based server\n  - [`polaris-admin`](.\u002Fruntime\u002Fadmin\u002FREADME.md) - admin tool, mainly for bootstrapping persistence\n  - [`polaris-runtime-service`](.\u002Fruntime\u002Fservice\u002FREADME.md) - the Polaris service package\n  - [`polaris-runtime-defaults`](.\u002Fruntime\u002Fdefaults\u002FREADME.md) - default runtime configuration\n  - [`polaris-distribution`](.\u002Fruntime\u002Fdistribution\u002FREADME.md) - distribution packaging\n  - `polaris-runtime-common`, `polaris-runtime-test-common` - shared runtime and test utilities\n  - `polaris-runtime-spark-tests` - integration tests for the Spark plugin\n- **Persistence**\n  - `polaris-relational-jdbc` - JDBC implementation of `BasePersistence`\n- **Extensions**\n  - [`polaris-extensions-federation-hive`](.\u002Fextensions\u002Ffederation\u002Fhive\u002FREADME.md), `polaris-extensions-federation-hadoop`, `polaris-extensions-federation-bigquery` - catalog federation\n  - `polaris-extensions-auth-opa`, `polaris-extensions-auth-ranger` (plus `*-tests`) - external authorization\n- **Tooling & build support**\n  - `polaris-bom`, `polaris-build-logic`, `polaris-version` - BOM, shared build logic, versioning\n  - `polaris-immutables`, `polaris-misc-types`, `polaris-container-spec-helper` - shared utilities\n  - `polaris-minio-testcontainer`, `polaris-rustfs-testcontainer`, `polaris-hms-testcontainer` - test containers\n  - `polaris-config-docs-{annotations,generator,site}` - reference-doc generation\n  - `aggregated-license-report` - aggregated license report\n- **Tests**\n  - [`polaris-tests`](.\u002Fintegration-tests\u002FREADME.md) - normative integration tests, reusable downstream\n\nOther top-level directories:\n\n- [`spec\u002F`](.\u002Fspec\u002FREADME.md) - OpenAPI specifications\n- [`client\u002Fpython\u002F`](.\u002Fclient\u002Fpython\u002FREADME.md) - Python client\n- [`plugins\u002Fspark\u002F`](.\u002Fplugins\u002Fspark\u002FREADME.md) - Polaris Spark plugin\n- [`regtests\u002F`](.\u002Fregtests\u002FREADME.md) - regression tests\n- [`helm\u002F`](.\u002Fhelm) - Helm charts\n- [`site\u002F`](.\u002Fsite\u002FREADME.md) - documentation site\n- [`codestyle\u002F`](.\u002Fcodestyle), [`gradle\u002F`](.\u002Fgradle), [`server-templates\u002F`](.\u002Fserver-templates) - build, style, and codegen support\n\nAdditional tooling lives in the separate [Polaris-Tools](https:\u002F\u002Fgithub.com\u002Fapache\u002Fpolaris-tools) repository.\n\n## Building and Running\n\nApache Polaris is built using Gradle with Java 21+ and Docker 27+.\n\n- `.\u002Fgradlew build` - To build and run tests. Make sure Docker is running, as the integration tests depend on it.\n- `.\u002Fgradlew assemble` - To skip tests.\n- `.\u002Fgradlew check` - To run all checks, including unit tests and integration tests.\n- `.\u002Fgradlew run` - To run the Polaris server locally; the server is reachable at localhost:8181. This is also suitable for running regression tests, or for connecting with Spark. Set your own credentials by specifying system property `.\u002Fgradlew run -Dpolaris.bootstrap.credentials=POLARIS,root,secret` where:\n  - `POLARIS` is the realm\n  - `root` is the CLIENT_ID\n  - `secret` is the CLIENT_SECRET\n  - If credentials are not set, it will use preset credentials `POLARIS,root,s3cr3t`\n- `.\u002Fregtests\u002Frun_spark_sql.sh` - To connect from Spark SQL. Here are some example commands to run in the Spark SQL shell:\n```sql\ncreate database db1;\nshow databases;\ncreate table db1.table1 (id int, name string);\ninsert into db1.table1 values (1, 'a');\nselect * from db1.table1;\n```\n- `env POLARIS_HOST=localhost .\u002Fregtests\u002Frun.sh` - To run regression tests locally, see more options [here](.\u002Fregtests\u002FREADME.md).\n\n## Makefile Convenience Commands\n\n- `make build-server`, `make build-admin` build components and container images\n- `make minikube-start-cluster`, `make minikube-cleanup` manage a local minikube cluster\n- `make helm-doc-generate`, `make helm-unittest` work with the Helm charts\n- `make client-lint`, `make client-regenerate` work with the Python client\n- `make install-dependencies-brew` install developer prerequisites on macOS\n\n### Running in Docker\n\nBuild the image locally:\n\n```bash\n.\u002Fgradlew \\\n  :polaris-server:assemble \\\n  :polaris-server:quarkusAppPartsBuild --rerun \\\n  -Dquarkus.container-image.build=true\n```\n\nRun the published image:\n\n```bash\ndocker run -p 8181:8181 -p 8182:8182 apache\u002Fpolaris:latest\n```\n\nThe repository also ships docker-compose examples for various configurations. See the\n[Quickstart](https:\u002F\u002Fpolaris.apache.org\u002Freleases\u002Flatest\u002Fgetting-started\u002Fquick-start\u002F) for details.\n\n### Running in Kubernetes\n\nSee [`helm\u002Fpolaris\u002FREADME.md`](helm\u002Fpolaris\u002FREADME.md).\n\n### Configuring Polaris\n\nServers can be configured in several ways: see the [Configuration Guide](https:\u002F\u002Fpolaris.apache.org\u002Freleases\u002Flatest\u002Fconfiguration\u002F).\nDefault values live in [`runtime\u002Fdefaults\u002Fsrc\u002Fmain\u002Fresources\u002Fapplication.properties`](.\u002Fruntime\u002Fdefaults\u002Fsrc\u002Fmain\u002Fresources\u002Fapplication.properties).\n\n### Building the docs\n\nDocs use [Hugo](https:\u002F\u002Fgohugo.io\u002F) with the [Docsy](https:\u002F\u002Fwww.docsy.dev\u002Fdocs\u002F) theme. To preview locally:\n\n```bash\nsite\u002Fbin\u002Frun-hugo-in-docker.sh\n```\n\nSee [`site\u002FREADME.md`](site\u002FREADME.md) for more.\n\n### Develocity build scans\n\nBuild scans for `apache\u002Fpolaris` branch and tag CI runs are published to the ASF Develocity instance at\n[develocity.apache.org](https:\u002F\u002Fdevelocity.apache.org\u002Fscans?search.rootProjectNames=polaris) when the\n`DEVELOCITY_ACCESS_KEY` org secret is available. Pull-request CI publishes to Gradle's public Develocity\ninstance instead.\n\nLocal builds publish a scan only when invoked with `--scan`, and only after you accept Gradle's\n[terms of service](https:\u002F\u002Fgradle.com\u002Fterms-of-service). Forks and other CI environments can opt in by setting\n`GRADLE_TOS_ACCEPTED=true`. Optional overrides: `DEVELOCITY_PROJECT_ID`, `DEVELOCITY_SERVER`, and a\n`DEVELOCITY_ACCESS_KEY` GitHub secret if you self-host Develocity.\n\n## License\n\nApache Polaris is under the Apache License Version 2.0. See the [LICENSE](LICENSE).\n","Apache Polaris 是一个为 Apache Iceberg 设计的开源目录服务。它实现了 Iceberg 的 REST API，支持跨多种平台（如 Apache Doris、Apache Flink、Apache Spark 等）的无缝多引擎互操作性。Polaris 采用 Java 语言开发，具备丰富的功能和高度的可扩展性，特别适合需要在不同数据处理框架间共享 Iceberg 表元数据的企业级应用环境。通过提供统一的元数据管理接口，Polaris 大大简化了大数据生态系统中组件间的集成复杂度。",2,"2026-06-11 03:53:25","trending"]