<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Configuration on Apache Polaris</title><link>https://polaris.apache.org/releases/1.9.0/configuration/</link><description>Recent content in Configuration on Apache Polaris</description><generator>Hugo</generator><language>en-us</language><copyright>&lt;a href="https://www.apache.org/"&gt;Copyright © 2026 The Apache Software Foundation&lt;/a&gt;.&lt;br&gt;Licensed under the &lt;a href="https://www.apache.org/licenses/LICENSE-2.0"&gt;Apache License, Version 2.0&lt;/a&gt;.</copyright><atom:link href="https://polaris.apache.org/releases/1.9.0/configuration/index.xml" rel="self" type="application/rss+xml"/><item><title>Configuring Polaris</title><link>https://polaris.apache.org/releases/1.9.0/configuration/configuring-polaris/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://polaris.apache.org/releases/1.9.0/configuration/configuring-polaris/</guid><description>&lt;h2 id="overview" id="overview"&gt;Overview&lt;a class="heading-anchor" href="#overview" aria-label="Anchor"&gt;🔗&lt;/a&gt;
&lt;/h2&gt;
&lt;p&gt;This page provides information on how to configure Apache Polaris. Unless stated
otherwise, this information is valid both for Polaris Docker images (and Kubernetes deployments) as
well as for Polaris binary distributions.&lt;/p&gt;
&lt;div class="alert alert-info"&gt;&lt;p class="alert-heading"&gt;
 📝 Note&lt;/p&gt;
 For Production tips and best practices, refer to &lt;a href="https://polaris.apache.org/releases/1.9.0/configuration/configuring-polaris-for-production/"&gt;Configuring Polaris for Production&lt;/a&gt;.
&lt;/div&gt;

&lt;p&gt;First off, Polaris server runs on Quarkus, and uses its configuration mechanisms. Read Quarkus
&lt;a href="https://quarkus.io/guides/config"&gt;configuration guide&lt;/a&gt; to get familiar with the basics.&lt;/p&gt;</description></item><item><title>Configuration Reference</title><link>https://polaris.apache.org/releases/1.9.0/configuration/configuration-reference/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://polaris.apache.org/releases/1.9.0/configuration/configuration-reference/</guid><description>&lt;p&gt;This document provides a comprehensive reference for all Polaris configuration options.&lt;/p&gt;
&lt;p&gt;All properties listed here are &lt;strong&gt;runtime&lt;/strong&gt; properties and can be changed without rebuilding Polaris.&lt;/p&gt;
&lt;h2 id="table-of-contents" id="table-of-contents"&gt;Table of Contents&lt;a class="heading-anchor" href="#table-of-contents" aria-label="Anchor"&gt;🔗&lt;/a&gt;
&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href="#features--behavior"&gt;Features &amp;amp; Behavior&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="#authentication--authorization"&gt;Authentication &amp;amp; Authorization&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="#storage--credentials"&gt;Storage &amp;amp; Credentials&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="#persistence"&gt;Persistence&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="#events"&gt;Events&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="#operational"&gt;Operational&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="#other"&gt;Other&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id="features--behavior" id="features--behavior"&gt;Features &amp;amp; Behavior&lt;a class="heading-anchor" href="#features--behavior" aria-label="Anchor"&gt;🔗&lt;/a&gt;
&lt;/h2&gt;
&lt;h3 id="how-the-effective-value-of-a-feature-is-determined" id="how-the-effective-value-of-a-feature-is-determined"&gt;How the effective value of a feature is determined&lt;a class="heading-anchor" href="#how-the-effective-value-of-a-feature-is-determined" aria-label="Anchor"&gt;🔗&lt;/a&gt;
&lt;/h3&gt;
&lt;p&gt;For a given catalog, the value of a feature is resolved in this order, and the first value that is
set wins:&lt;/p&gt;</description></item><item><title>Structured and Unstructured Table Locations</title><link>https://polaris.apache.org/releases/1.9.0/configuration/structured-and-unstructured-table-locations/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://polaris.apache.org/releases/1.9.0/configuration/structured-and-unstructured-table-locations/</guid><description>&lt;p&gt;Polaris supports two modes that decide where Iceberg tables and views may be located in a catalog:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Structured locations&lt;/strong&gt;, the default. A table&amp;rsquo;s or view&amp;rsquo;s location must be inside the location of
its namespace, and a table&amp;rsquo;s &lt;code&gt;write.data.path&lt;/code&gt; and &lt;code&gt;write.metadata.path&lt;/code&gt; must be inside the
table&amp;rsquo;s own location.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Unstructured locations&lt;/strong&gt;. Table and view locations, and write paths, may be anywhere inside the
catalog&amp;rsquo;s allowed locations.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;In both modes, all locations must be inside the catalog&amp;rsquo;s allowed locations. Unstructured locations
are enabled by setting the feature
&lt;a href="https://polaris.apache.org/releases/1.9.0/configuration/configuration-reference/#polarisfeaturesallow_unstructured_table_location"&gt;&lt;code&gt;ALLOW_UNSTRUCTURED_TABLE_LOCATION&lt;/code&gt;&lt;/a&gt;
or the catalog property &lt;code&gt;polaris.config.allow.unstructured.table.location&lt;/code&gt; to &lt;code&gt;true&lt;/code&gt;.&lt;/p&gt;</description></item><item><title>Storage Layout</title><link>https://polaris.apache.org/releases/1.9.0/configuration/storage-layout/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://polaris.apache.org/releases/1.9.0/configuration/storage-layout/</guid><description>&lt;p&gt;This page explains where Polaris places namespaces, tables, and views in object storage, and how
the settings that change this layout interact. Several of these settings have overlapping effects,
and some combinations are rejected, so it is worth reading this page before changing any of them.&lt;/p&gt;
&lt;p&gt;This page covers internal catalogs. Federated catalogs are served by a remote catalog, which owns
the table locations, so none of the rules on this page apply to them. External catalogs without a
federation connection store their tables in Polaris, but the locations are set by the system that
updates them rather than generated by Polaris. Only some of the rules below apply to them, and the
sections below note where they differ.&lt;/p&gt;</description></item></channel></rss>