From ed4c0cbf3650ab46bfc2f3a8c863503f28f9a6e9 Mon Sep 17 00:00:00 2001
From: Dmitri Bourlatchkov <dmitri.bourlatchkov@dremio.com>
Date: Wed, 4 Sep 2024 11:46:50 -0400
Subject: [PATCH] Correct the handling of access delegation mode (#211)

---
 docs/index.html                               |  6 +-
 docs/quickstart.md                            |  2 +-
 notebooks/SparkPolaris.ipynb                  |  4 +-
 .../service/catalog/AccessDelegationMode.java | 74 +++++++++++++++++++
 .../catalog/IcebergCatalogAdapter.java        | 34 ++++++---
 .../catalog/PolarisCatalogHandlerWrapper.java |  4 +-
 .../catalog/AccessDelegationModeTest.java     | 66 +++++++++++++++++
 ...PolarisCatalogHandlerWrapperAuthzTest.java | 16 ++--
 regtests/setup.sh                             |  2 +-
 regtests/t_pyspark/src/iceberg_spark.py       |  2 +-
 spec/index.yaml                               |  2 +-
 11 files changed, 181 insertions(+), 31 deletions(-)
 create mode 100644 polaris-service/src/main/java/org/apache/polaris/service/catalog/AccessDelegationMode.java
 create mode 100644 polaris-service/src/test/java/org/apache/polaris/service/catalog/AccessDelegationModeTest.java

diff --git a/docs/index.html b/docs/index.html
index 67c333ee6..861bce66e 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -777,7 +777,7 @@ <h3 id="creating-a-principal-and-assigning-it-privileges">Creating a Principal a
 &lt;span class=&quot;token parameter variable&quot;&gt;--packages&lt;/span&gt; org.apache.iceberg:iceberg-spark-runtime-3.5_2.12:1.5.2,org.apache.hadoop:hadoop-aws:3.4.0 &lt;span class=&quot;token punctuation&quot;&gt;\&lt;/span&gt;
 &lt;span class=&quot;token parameter variable&quot;&gt;--conf&lt;/span&gt; &lt;span class=&quot;token assign-left variable&quot;&gt;spark.sql.extensions&lt;/span&gt;&lt;span class=&quot;token operator&quot;&gt;=&lt;/span&gt;org.apache.iceberg.spark.extensions.IcebergSparkSessionExtensions &lt;span class=&quot;token punctuation&quot;&gt;\&lt;/span&gt;
 &lt;span class=&quot;token parameter variable&quot;&gt;--conf&lt;/span&gt; &lt;span class=&quot;token assign-left variable&quot;&gt;spark.sql.catalog.quickstart_catalog.warehouse&lt;/span&gt;&lt;span class=&quot;token operator&quot;&gt;=&lt;/span&gt;quickstart_catalog &lt;span class=&quot;token punctuation&quot;&gt;\&lt;/span&gt;
-&lt;span class=&quot;token parameter variable&quot;&gt;--conf&lt;/span&gt; spark.sql.catalog.quickstart_catalog.header.X-Iceberg-Access-Delegation&lt;span class=&quot;token operator&quot;&gt;=&lt;/span&gt;true &lt;span class=&quot;token punctuation&quot;&gt;\&lt;/span&gt;
+&lt;span class=&quot;token parameter variable&quot;&gt;--conf&lt;/span&gt; spark.sql.catalog.quickstart_catalog.header.X-Iceberg-Access-Delegation&lt;span class=&quot;token operator&quot;&gt;=&lt;/span&gt;vended-credentials &lt;span class=&quot;token punctuation&quot;&gt;\&lt;/span&gt;
 &lt;span class=&quot;token parameter variable&quot;&gt;--conf&lt;/span&gt; &lt;span class=&quot;token assign-left variable&quot;&gt;spark.sql.catalog.quickstart_catalog&lt;/span&gt;&lt;span class=&quot;token operator&quot;&gt;=&lt;/span&gt;org.apache.iceberg.spark.SparkCatalog &lt;span class=&quot;token punctuation&quot;&gt;\&lt;/span&gt;
 &lt;span class=&quot;token parameter variable&quot;&gt;--conf&lt;/span&gt; spark.sql.catalog.quickstart_catalog.catalog-impl&lt;span class=&quot;token operator&quot;&gt;=&lt;/span&gt;org.apache.iceberg.rest.RESTCatalog &lt;span class=&quot;token punctuation&quot;&gt;\&lt;/span&gt;
 &lt;span class=&quot;token parameter variable&quot;&gt;--conf&lt;/span&gt; &lt;span class=&quot;token assign-left variable&quot;&gt;spark.sql.catalog.quickstart_catalog.uri&lt;/span&gt;&lt;span class=&quot;token operator&quot;&gt;=&lt;/span&gt;http://localhost:8181/api/catalog &lt;span class=&quot;token punctuation&quot;&gt;\&lt;/span&gt;
@@ -835,7 +835,7 @@ <h3 id="connecting-with-spark">Connecting with Spark</h3>
 <span class="token parameter variable">--packages</span> org.apache.iceberg:iceberg-spark-runtime-3.5_2.12:1.5.2,org.apache.hadoop:hadoop-aws:3.4.0 <span class="token punctuation">\</span>
 <span class="token parameter variable">--conf</span> <span class="token assign-left variable">spark.sql.extensions</span><span class="token operator">=</span>org.apache.iceberg.spark.extensions.IcebergSparkSessionExtensions <span class="token punctuation">\</span>
 <span class="token parameter variable">--conf</span> <span class="token assign-left variable">spark.sql.catalog.quickstart_catalog.warehouse</span><span class="token operator">=</span>quickstart_catalog <span class="token punctuation">\</span>
-<span class="token parameter variable">--conf</span> spark.sql.catalog.quickstart_catalog.header.X-Iceberg-Access-Delegation<span class="token operator">=</span>true <span class="token punctuation">\</span>
+<span class="token parameter variable">--conf</span> spark.sql.catalog.quickstart_catalog.header.X-Iceberg-Access-Delegation<span class="token operator">=</span>vended-credentials <span class="token punctuation">\</span>
 <span class="token parameter variable">--conf</span> <span class="token assign-left variable">spark.sql.catalog.quickstart_catalog</span><span class="token operator">=</span>org.apache.iceberg.spark.SparkCatalog <span class="token punctuation">\</span>
 <span class="token parameter variable">--conf</span> spark.sql.catalog.quickstart_catalog.catalog-impl<span class="token operator">=</span>org.apache.iceberg.rest.RESTCatalog <span class="token punctuation">\</span>
 <span class="token parameter variable">--conf</span> <span class="token assign-left variable">spark.sql.catalog.quickstart_catalog.uri</span><span class="token operator">=</span>http://localhost:8181/api/catalog <span class="token punctuation">\</span>
@@ -3650,7 +3650,7 @@ <h4 id="featureconfigurationsupported_catalog_storage_types">featureConfiguratio
 " class="sc-euGpHm sc-exayXG fwfkcU jYGAQp"><p>Generic base server URL, with all parts configurable</p>
 </div><div tabindex="0" role="button"><div class="sc-hDcvty jpmGrk"><span>{scheme}://{host}:{port}/{basePath}</span>/v1/{prefix}/views/rename</div></div></div></div></div><div><h3 class="sc-kkmypM jKNCPF"> <!-- -->Request samples<!-- --> </h3><div class="sc-bSlUec jxQggo" data-rttabs="true"><ul class="react-tabs__tab-list" role="tablist"><li class="react-tabs__tab react-tabs__tab--selected" role="tab" id="tab:R2ae5qa:0" aria-selected="true" aria-disabled="false" aria-controls="panel:R2ae5qa:0" tabindex="0" data-rttab="true">Payload</li></ul><div class="react-tabs__tab-panel react-tabs__tab-panel--selected" role="tabpanel" id="panel:R2ae5qa:0" aria-labelledby="tab:R2ae5qa:0"><div><div class="sc-WChnI iLXIA-d"><span class="sc-foMnoT dmNpjh">Content type</span><div class="sc-ZubPq KmnOC">application/json</div></div><div class="sc-AmOMz gDrQpr"><div class="sc-eTdEpr dgzSkD"><div class="sc-pFPEP bMXXJy"><button><div class="sc-eHujzY ecCAmX">Copy</div></button><button> Expand all </button><button> Collapse all </button></div><div class="sc-euGpHm fwfkcU sc-fTgapq bDqsIm"><div class="redoc-json"><code><button class="collapser" aria-label="collapse"></button><span class="token punctuation">{</span><span class="ellipsis"></span><ul class="obj collapsible"><li><div class="hoverable "><span class="property token string">"source"</span>: <button class="collapser" aria-label="collapse"></button><span class="token punctuation">{</span><span class="ellipsis"></span><ul class="obj collapsible"><li><div class="hoverable collapsed"><span class="property token string">"namespace"</span>: <button class="collapser" aria-label="expand"></button><span class="token punctuation">[</span><span class="ellipsis"></span><ul class="array collapsible"><li><div class="hoverable collapsed"><span class="token string">&quot;accounting&quot;</span>,</div></li><li><div class="hoverable collapsed"><span class="token string">&quot;tax&quot;</span></div></li></ul><span class="token punctuation">]</span><span class="token punctuation">,</span></div></li><li><div class="hoverable collapsed"><span class="property token string">"name"</span>: <span class="token string">&quot;paid-view&quot;</span></div></li></ul><span class="token punctuation">}</span><span class="token punctuation">,</span></div></li><li><div class="hoverable "><span class="property token string">"destination"</span>: <button class="collapser" aria-label="collapse"></button><span class="token punctuation">{</span><span class="ellipsis"></span><ul class="obj collapsible"><li><div class="hoverable collapsed"><span class="property token string">"namespace"</span>: <button class="collapser" aria-label="expand"></button><span class="token punctuation">[</span><span class="ellipsis"></span><ul class="array collapsible"><li><div class="hoverable collapsed"><span class="token string">&quot;accounting&quot;</span>,</div></li><li><div class="hoverable collapsed"><span class="token string">&quot;tax&quot;</span></div></li></ul><span class="token punctuation">]</span><span class="token punctuation">,</span></div></li><li><div class="hoverable collapsed"><span class="property token string">"name"</span>: <span class="token string">&quot;owed-view&quot;</span></div></li></ul><span class="token punctuation">}</span></div></li></ul><span class="token punctuation">}</span></code></div></div></div></div></div></div></div></div><div><h3 class="sc-kkmypM jKNCPF"> <!-- -->Response samples<!-- --> </h3><div class="sc-bSlUec jxQggo" data-rttabs="true"><ul class="react-tabs__tab-list" role="tablist"><li class="tab-error react-tabs__tab--selected" role="tab" id="tab:R2ee5qa:0" aria-selected="true" aria-disabled="false" aria-controls="panel:R2ee5qa:0" tabindex="0" data-rttab="true">400</li><li class="tab-error" role="tab" id="tab:R2ee5qa:1" aria-selected="false" aria-disabled="false" aria-controls="panel:R2ee5qa:1" data-rttab="true">401</li><li class="tab-error" role="tab" id="tab:R2ee5qa:2" aria-selected="false" aria-disabled="false" aria-controls="panel:R2ee5qa:2" data-rttab="true">403</li><li class="tab-error" role="tab" id="tab:R2ee5qa:3" aria-selected="false" aria-disabled="false" aria-controls="panel:R2ee5qa:3" data-rttab="true">404</li><li class="tab-error" role="tab" id="tab:R2ee5qa:4" aria-selected="false" aria-disabled="false" aria-controls="panel:R2ee5qa:4" data-rttab="true">406</li><li class="tab-error" role="tab" id="tab:R2ee5qa:5" aria-selected="false" aria-disabled="false" aria-controls="panel:R2ee5qa:5" data-rttab="true">409</li><li class="tab-error" role="tab" id="tab:R2ee5qa:6" aria-selected="false" aria-disabled="false" aria-controls="panel:R2ee5qa:6" data-rttab="true">419</li><li class="tab-error" role="tab" id="tab:R2ee5qa:7" aria-selected="false" aria-disabled="false" aria-controls="panel:R2ee5qa:7" data-rttab="true">503</li><li class="tab-error" role="tab" id="tab:R2ee5qa:8" aria-selected="false" aria-disabled="false" aria-controls="panel:R2ee5qa:8" data-rttab="true">5XX</li></ul><div class="react-tabs__tab-panel react-tabs__tab-panel--selected" role="tabpanel" id="panel:R2ee5qa:0" aria-labelledby="tab:R2ee5qa:0"><div><div class="sc-WChnI iLXIA-d"><span class="sc-foMnoT dmNpjh">Content type</span><div class="sc-ZubPq KmnOC">application/json</div></div><div class="sc-AmOMz gDrQpr"><div class="sc-eTdEpr dgzSkD"><div class="sc-pFPEP bMXXJy"><button><div class="sc-eHujzY ecCAmX">Copy</div></button><button> Expand all </button><button> Collapse all </button></div><div class="sc-euGpHm fwfkcU sc-fTgapq bDqsIm"><div class="redoc-json"><code><button class="collapser" aria-label="collapse"></button><span class="token punctuation">{</span><span class="ellipsis"></span><ul class="obj collapsible"><li><div class="hoverable "><span class="property token string">"error"</span>: <button class="collapser" aria-label="collapse"></button><span class="token punctuation">{</span><span class="ellipsis"></span><ul class="obj collapsible"><li><div class="hoverable collapsed"><span class="property token string">"message"</span>: <span class="token string">&quot;Malformed request&quot;</span><span class="token punctuation">,</span></div></li><li><div class="hoverable collapsed"><span class="property token string">"type"</span>: <span class="token string">&quot;BadRequestException&quot;</span><span class="token punctuation">,</span></div></li><li><div class="hoverable collapsed"><span class="property token string">"code"</span>: <span class="token number">400</span></div></li></ul><span class="token punctuation">}</span></div></li></ul><span class="token punctuation">}</span></code></div></div></div></div></div></div><div class="react-tabs__tab-panel" role="tabpanel" id="panel:R2ee5qa:1" aria-labelledby="tab:R2ee5qa:1"></div><div class="react-tabs__tab-panel" role="tabpanel" id="panel:R2ee5qa:2" aria-labelledby="tab:R2ee5qa:2"></div><div class="react-tabs__tab-panel" role="tabpanel" id="panel:R2ee5qa:3" aria-labelledby="tab:R2ee5qa:3"></div><div class="react-tabs__tab-panel" role="tabpanel" id="panel:R2ee5qa:4" aria-labelledby="tab:R2ee5qa:4"></div><div class="react-tabs__tab-panel" role="tabpanel" id="panel:R2ee5qa:5" aria-labelledby="tab:R2ee5qa:5"></div><div class="react-tabs__tab-panel" role="tabpanel" id="panel:R2ee5qa:6" aria-labelledby="tab:R2ee5qa:6"></div><div class="react-tabs__tab-panel" role="tabpanel" id="panel:R2ee5qa:7" aria-labelledby="tab:R2ee5qa:7"></div><div class="react-tabs__tab-panel" role="tabpanel" id="panel:R2ee5qa:8" aria-labelledby="tab:R2ee5qa:8"></div></div></div></div></div></div></div><div class="sc-epzHnm bWkBKa"></div></div></div>
       <script>
-      const __redoc_state = {"menu":{"activeItemIdx":-1},"spec":{"data":{"openapi":"3.0.0","info":{"title":"Apache Polaris (Incubating) Documentation","x-logo":{"url":"./img/logos/polaris-catalog-stacked-logo.svg","altText":"Apache Polaris Logo"},"description":"<!--\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://www.apache.org/licenses/LICENSE-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# Quick Start\n\nThis guide serves as a introduction to several key entities that can be managed with Apache Polaris (Incubating), describes how to build and deploy Polaris locally, and finally includes examples of how to use Polaris with Apache Spark&trade;.\n\n## Prerequisites\n\nThis guide covers building Polaris, deploying it locally or via [Docker](https://www.docker.com/), and interacting with it using the command-line interface and [Apache Spark](https://spark.apache.org/). Before proceeding with Polaris, be sure to satisfy the relevant prerequisites listed here.\n\n### Building and Deploying Polaris\n\nTo get the latest Polaris code, you'll need to clone the repository using [git](https://git-scm.com/). You can install git using [homebrew](https://brew.sh/):\n\n```shell\nbrew install git\n```\n\nThen, use git to clone the Polaris repo:\n\n```shell\ncd ~\ngit clone https://github.com/apache/polaris.git\n```\n\n#### With Docker\n\nIf you plan to deploy Polaris inside [Docker](https://www.docker.com/), you'll need to install docker itself. For example, this can be done using [homebrew](https://brew.sh/):\n\n```shell\nbrew install --cask docker\n```\n\nOnce installed, make sure Docker is running.\n\n#### From Source\n\nIf you plan to build Polaris from source yourself, you will need to satisfy a few prerequisites first.\n\nPolaris is built using [gradle](https://gradle.org/) and is compatible with Java 21. We recommend the use of [jenv](https://www.jenv.be/) to manage multiple Java versions. For example, to install Java 21 via [homebrew](https://brew.sh/) and configure it with jenv: \n\n```shell\ncd ~/polaris\nbrew install openjdk@21 jenv\njenv add $(brew --prefix openjdk@21)\njenv local 21\n```\n\n### Connecting to Polaris\n\nPolaris is compatible with any [Apache Iceberg](https://iceberg.apache.org/) client that supports the REST API. Depending on the client you plan to use, refer to the prerequisites below.\n\n#### With Spark\n\nIf you want to connect to Polaris with [Apache Spark](https://spark.apache.org/), you'll need to start by cloning Spark. As [above](#building-and-deploying-polaris), make sure [git](https://git-scm.com/) is installed first. You can install it with [homebrew](https://brew.sh/):\n\n```shell\nbrew install git\n```\n\nThen, clone Spark and check out a versioned branch. This guide uses [Spark 3.5](https://spark.apache.org/releases/spark-release-3-5-0.html).\n\n```shell\ncd ~\ngit clone https://github.com/apache/spark.git\ncd ~/spark\ngit checkout branch-3.5\n```\n\n## Deploying Polaris\n\nPolaris can be deployed via a lightweight docker image or as a standalone process. Before starting, be sure that you've satisfied the relevant [prerequisites](#building-and-deploying-polaris) detailed above.\n\n### Docker Image\n\nTo start using Polaris in Docker, launch Polaris while Docker is running:\n\n```shell\ncd ~/polaris\ndocker compose -f docker-compose.yml up --build\n```\n\nOnce the `polaris-polaris` container is up, you can continue to [Defining a Catalog](#defining-a-catalog).\n\n### Building Polaris\n\nRun Polaris locally with:\n\n```shell\ncd ~/polaris\n./gradlew runApp\n```\n\nYou should see output for some time as Polaris builds and starts up. Eventually, you won’t see any more logs and should see messages that resemble the following:\n\n```\nINFO  [...] [main] [] o.e.j.s.handler.ContextHandler: Started i.d.j.MutableServletContextHandler@...\nINFO  [...] [main] [] o.e.j.server.AbstractConnector: Started application@...\nINFO  [...] [main] [] o.e.j.server.AbstractConnector: Started admin@...\nINFO  [...] [main] [] o.eclipse.jetty.server.Server: Started Server@...\n```\n\nAt this point, Polaris is running.\n\n## Bootstrapping Polaris\n\nFor this tutorial, we'll launch an instance of Polaris that stores entities only in-memory. This means that any entities that you define will be destroyed when Polaris is shut down. It also means that Polaris will automatically bootstrap itself with root credentials. For more information on how to configure Polaris for production usage, see the [docs](./configuring-polaris-for-production.md).\n\nWhen Polaris is launched using in-memory mode the root principal credentials can be found in stdout on initial startup. For example:\n\n```\nrealm: default-realm root principal credentials: <client-id>:<client-secret>\n```\n\nBe sure to note of these credentials as we'll be using them below. You can also set these credentials as environment variables for use with the Polaris CLI:\n\n```shell\nexport CLIENT_ID=<client-id> \nexport CLIENT_SECRET=<client-secret>\n```\n\n## Defining a Catalog\n\nIn Polaris, the [catalog](./entities.md#catalog) is the top-level entity that objects like [tables](./entities.md#table) and [views](./entities.md#view) are organized under. With a Polaris service running, you can create a catalog like so:\n\n```shell\ncd ~/polaris\n\n./polaris \\\n  --client-id ${CLIENT_ID} \\\n  --client-secret ${CLIENT_SECRET} \\\n  catalogs \\\n  create \\\n  --storage-type s3 \\\n  --default-base-location ${DEFAULT_BASE_LOCATION} \\\n  --role-arn ${ROLE_ARN} \\\n  quickstart_catalog\n```\n\nThis will create a new catalog called **quickstart_catalog**.\n\nThe `DEFAULT_BASE_LOCATION` you provide will be the default location that objects in this catalog should be stored in, and the `ROLE_ARN` you provide should be a [Role ARN](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) with access to read and write data in that location. These credentials will be provided to engines reading data from the catalog once they have authenticated with Polaris using credentials that have access to those resources.\n\nIf you’re using a storage type other than S3, such as Azure, you’ll provide a different type of credential than a Role ARN. For more details on supported storage types, see the [docs](./entities.md#storage-type).\n\nAdditionally, if Polaris is running somewhere other than `localhost:8181`, you can specify the correct hostname and port by providing `--host` and `--port` flags. For the full set of options supported by the CLI, please refer to the [docs](./command-line-interface.md).\n\n\n### Creating a Principal and Assigning it Privileges\n\nWith a catalog created, we can create a [principal](./entities.md#principal) that has access to manage that catalog. For details on how to configure the Polaris CLI, see [the section above](#defining-a-catalog) or refer to the [docs](./command-line-interface.md).\n\n```shell\n./polaris \\\n  --client-id ${CLIENT_ID} \\\n  --client-secret ${CLIENT_SECRET} \\\n  principals \\\n  create \\\n  quickstart_user\n\n./polaris \\\n  --client-id ${CLIENT_ID} \\\n  --client-secret ${CLIENT_SECRET} \\\n  principal-roles \\\n  create \\\n  quickstart_user_role\n\n./polaris \\\n  --client-id ${CLIENT_ID} \\\n  --client-secret ${CLIENT_SECRET} \\\n  catalog-roles \\\n  create \\\n  --catalog quickstart_catalog \\\n  quickstart_catalog_role\n```\n\nBe sure to provide the necessary credentials, hostname, and port as before.\n\nWhen the `principals create` command completes successfully, it will return the credentials for this new principal. Be sure to note these down for later. For example:\n\n```\n./polaris ... principals create example\n{\"clientId\": \"XXXX\", \"clientSecret\": \"YYYY\"}\n```\n\nNow, we grant the principal the [principal role](./entities.md#principal-role) we created, and grant the [catalog role](./entities.md#catalog-role) the principal role we created. For more information on these entities, please refer to the linked documentation.\n\n```shell\n./polaris \\\n  --client-id ${CLIENT_ID} \\\n  --client-secret ${CLIENT_SECRET} \\\n  principal-roles \\\n  grant \\\n  --principal quickstart_user \\\n  quickstart_user_role\n\n./polaris \\\n  --client-id ${CLIENT_ID} \\\n  --client-secret ${CLIENT_SECRET} \\\n  catalog-roles \\\n  grant \\\n  --catalog quickstart_catalog \\\n  --principal-role quickstart_user_role \\\n  quickstart_catalog_role\n```\n\nNow, we’ve linked our principal to the catalog via roles like so:\n\n![Principal to Catalog](./img/quickstart/privilege-illustration-1.png \"Principal to Catalog\")\n\nIn order to give this principal the ability to interact with the catalog, we must assign some [privileges](./entities.md#privilege). For the time being, we will give this principal the ability to fully manage content in our new catalog. We can do this with the CLI like so:\n\n```shell\n./polaris \\\n  --client-id ${CLIENT_ID} \\\n  --client-secret ${CLIENT_SECRET} \\\n  privileges \\\n  catalog \\\n  grant \\\n  --catalog quickstart_catalog \\\n  --catalog-role quickstart_catalog_role \\\n  CATALOG_MANAGE_CONTENT\n```\n\nThis grants the [catalog privileges](./entities.md#privilege) `CATALOG_MANAGE_CONTENT` to our catalog role, linking everything together like so:\n\n![Principal to Catalog with Catalog Role](./img/quickstart/privilege-illustration-2.png \"Principal to Catalog with Catalog Role\")\n\n`CATALOG_MANAGE_CONTENT` has create/list/read/write privileges on all entities within the catalog. The same privilege could be granted to a namespace, in which case the principal could create/list/read/write any entity under that namespace.\n\n## Using Iceberg & Polaris\n\nAt this point, we’ve created a principal and granted it the ability to manage a catalog. We can now use an external engine to assume that principal, access our catalog, and store data in that catalog using [Apache Iceberg](https://iceberg.apache.org/).\n\n### Connecting with Spark\n\nTo use a Polaris-managed catalog in [Apache Spark](https://spark.apache.org/), we can configure Spark to use the Iceberg catalog REST API.\n\nThis guide uses [Apache Spark 3.5](https://spark.apache.org/releases/spark-release-3-5-0.html), but be sure to find [the appropriate iceberg-spark package for your Spark version](https://mvnrepository.com/artifact/org.apache.iceberg/iceberg-spark). From a local Spark clone on the `branch-3.5` branch we can run the following:\n\n_Note: the credentials provided here are those for our principal, not the root credentials._\n\n```shell\nbin/spark-shell \\\n--packages org.apache.iceberg:iceberg-spark-runtime-3.5_2.12:1.5.2,org.apache.hadoop:hadoop-aws:3.4.0 \\\n--conf spark.sql.extensions=org.apache.iceberg.spark.extensions.IcebergSparkSessionExtensions \\\n--conf spark.sql.catalog.quickstart_catalog.warehouse=quickstart_catalog \\\n--conf spark.sql.catalog.quickstart_catalog.header.X-Iceberg-Access-Delegation=true \\\n--conf spark.sql.catalog.quickstart_catalog=org.apache.iceberg.spark.SparkCatalog \\\n--conf spark.sql.catalog.quickstart_catalog.catalog-impl=org.apache.iceberg.rest.RESTCatalog \\\n--conf spark.sql.catalog.quickstart_catalog.uri=http://localhost:8181/api/catalog \\\n--conf spark.sql.catalog.quickstart_catalog.credential='XXXX:YYYY' \\\n--conf spark.sql.catalog.quickstart_catalog.scope='PRINCIPAL_ROLE:ALL' \\\n--conf spark.sql.catalog.quickstart_catalog.token-refresh-enabled=true\n```\n\n\nReplace `XXXX` and `YYYY` with the client ID and client secret generated when you created the `quickstart_user` principal.\n\nSimilar to the CLI commands above, this configures Spark to use the Polaris running at `localhost:8181`. If your Polaris server is running elsewhere, but sure to update the configuration appropriately.\n\nFinally, note that we include the `hadoop-aws` package here. If your table is using a different filesystem, be sure to include the appropriate dependency.\n\nOnce the Spark session starts, we can create a namespace and table within the catalog:\n\n```\nspark.sql(\"USE quickstart_catalog\")\nspark.sql(\"CREATE NAMESPACE IF NOT EXISTS quickstart_namespace\")\nspark.sql(\"CREATE NAMESPACE IF NOT EXISTS quickstart_namespace.schema\")\nspark.sql(\"USE NAMESPACE quickstart_namespace.schema\")\nspark.sql(\"\"\"\n\tCREATE TABLE IF NOT EXISTS quickstart_table (\n\t\tid BIGINT, data STRING\n\t) \nUSING ICEBERG\n\"\"\")\n```\n\nWe can now use this table like any other:\n\n```\nspark.sql(\"INSERT INTO quickstart_table VALUES (1, 'some data')\")\nspark.sql(\"SELECT * FROM quickstart_table\").show(false)\n. . .\n+---+---------+\n|id |data     |\n+---+---------+\n|1  |some data|\n+---+---------+\n```\n\nIf at any time access is revoked...\n\n```shell\n./polaris \\\n  --client-id ${CLIENT_ID} \\\n  --client-secret ${CLIENT_SECRET} \\\n  privileges \\\n  catalog \\\n  revoke \\\n  --catalog quickstart_catalog \\\n  --catalog-role quickstart_catalog_role \\\n  CATALOG_MANAGE_CONTENT\n```\n\nSpark will lose access to the table:\n\n```\nspark.sql(\"SELECT * FROM quickstart_table\").show(false)\n\norg.apache.iceberg.exceptions.ForbiddenException: Forbidden: Principal 'quickstart_user' with activated PrincipalRoles '[]' and activated ids '[6, 7]' is not authorized for op LOAD_TABLE_WITH_READ_DELEGATION\n```\n","contact":{"email":"dev [at] polaris.apache.org","url":"https://github.com/apache/polaris"},"license":{"name":"Apache v2.0","url":"https://github.com/apache/polaris/blob/main/LICENSE"}},"servers":[{"url":"{scheme}://{host}/api/management/v1","description":"Server URL when the port can be inferred from the scheme","variables":{"scheme":{"description":"The scheme of the URI, either http or https.","default":"https"},"host":{"description":"The host address for the specified server","default":"localhost"}}},{"url":"{scheme}://{host}/{basePath}","description":"Server URL when the port can be inferred from the scheme","variables":{"scheme":{"description":"The scheme of the URI, either http or https.","default":"https"},"host":{"description":"The host address for the specified server","default":"localhost"},"basePath":{"description":"Optional prefix to be appended to all routes","default":""}}},{"url":"{scheme}://{host}:{port}/{basePath}","description":"Generic base server URL, with all parts configurable","variables":{"scheme":{"description":"The scheme of the URI, either http or https.","default":"https"},"host":{"description":"The host address for the specified server","default":"localhost"},"port":{"description":"The port used when addressing the host","default":"443"},"basePath":{"description":"Optional prefix to be appended to all routes","default":""}}}],"tags":[{"name":"Overview","description":"<!--\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://www.apache.org/licenses/LICENSE-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\nApache Polaris (Incubating) is a catalog implementation for Apache Iceberg&trade; tables and is built on the open source Apache Iceberg&trade; REST protocol.\n\nWith Polaris, you can provide centralized, secure read and write access to your Iceberg tables across different REST-compatible query engines.\n\n![Conceptual diagram of Apache Polaris (Incubating).](img/overview.svg \"Apache Polaris (Incubating) overview\")\n\n## Key concepts\n\nThis section introduces key concepts associated with using Apache Polaris (Incubating).\n\nIn the following diagram, a sample [Apache Polaris (Incubating) structure](overview.md#catalog) with nested [namespaces](overview.md#namespace) is shown for Catalog1. No tables\nor namespaces have been created yet for Catalog2 or Catalog3.\n\n![Diagram that shows an example Apache Polaris (Incubating) structure.](img/sample-catalog-structure.svg \"Sample Apache Polaris (Incubating) structure\")\n\n### Catalog\n\nIn Polaris, you can create one or more catalog resources to organize Iceberg tables.\n\nConfigure your catalog by setting values in the storage configuration for S3, Azure, or Google Cloud Storage. An Iceberg catalog enables a\nquery engine to manage and organize tables. The catalog forms the first architectural layer in the [Apache Iceberg&trade; table specification](https://iceberg.apache.org/spec/#overview) and must support the following tasks:\n\n- Storing the current metadata pointer for one or more Iceberg tables. A metadata pointer maps a table name to the location of that table's\n    current metadata file.\n\n- Performing atomic operations so that you can update the current metadata pointer for a table to the metadata pointer of a new version of\n  the table.\n\nTo learn more about Iceberg catalogs, see the [Apache Iceberg&trade; documentation](https://iceberg.apache.org/concepts/catalog/).\n\n#### Catalog types\n\nA catalog can be one of the following two types:\n\n- Internal: The catalog is managed by Polaris. Tables from this catalog can be read and written in Polaris.\n\n- External: The catalog is externally managed by another Iceberg catalog provider (for example, Snowflake, Glue, Dremio Arctic). Tables from \n  this catalog are synced to Polaris. These tables are read-only in Polaris. In the current release, only a Snowflake external catalog is provided.\n\nA catalog is configured with a storage configuration that can point to S3, Azure storage, or GCS.\n\n### Namespace\n\nYou create *namespaces* to logically group Iceberg tables within a catalog. A catalog can have multiple namespaces. You can also create\nnested namespaces. Iceberg tables belong to namespaces.\n\n### Apache Iceberg&trade; tables and catalogs\n\nIn an internal catalog, an Iceberg table is registered in Polaris, but read and written via query engines. The table data and\nmetadata is stored in your external cloud storage. The table uses Polaris as the Iceberg catalog.\n\nIf you have tables that use Snowflake as the Iceberg catalog (Snowflake-managed tables), you can sync these tables to an external\ncatalog in Polaris. If you sync this catalog to Polaris, it appears as an external catalog in Polaris. The table data and\nmetadata is stored in your external cloud storage. The Snowflake query engine can read from or write to these tables. However, the other query\nengines can only read from these tables.\n\n> **Important**\n>\n> For the access privileges defined for a catalog to be enforced correctly, the following conditions must be met:\n>\n> - The directory only contains the data files that belong to a single table.\n> - The directory hierarchy matches the namespace hierarchy for the catalog.\n>\n> For example, if a catalog includes the following items:\n>\n> - Top-level namespace namespace1\n> - Nested namespace namespace1a\n> - A customers table, which is grouped under nested namespace namespace1a\n> - An orders table, which is grouped under nested namespace namespace1a\n>\n> The directory hierarchy for the catalog must follow this structure:\n>\n> - /namespace1/namespace1a/customers/<files for the customers table *only*>\n> - /namespace1/namespace1a/orders/<files for the orders table *only*>\n\n### Service principal\n\nA service principal is an entity that you create in Polaris. Each service principal encapsulates credentials that you use to connect\nto Polaris.\n\nQuery engines use service principals to connect to catalogs.\n\nPolaris generates a Client ID and Client Secret pair for each service principal.\n\nThe following table displays example service principals that you might create in Polaris:\n\n  | Service connection name     | Purpose |\n  | --------------------------- | ----------- |\n  |  Flink ingestion            | For Apache Flink&reg; to ingest streaming data into Apache Iceberg&trade; tables. |\n  |  Spark ETL pipeline         | For Apache Spark&trade; to run ETL pipeline jobs on Iceberg tables. |\n  |  Snowflake data pipelines   | For Snowflake to run data pipelines for transforming data in Apache Iceberg&trade; tables.  |\n  |  Trino BI dashboard         | For Trino to run BI queries for powering a dashboard. |\n  |  Snowflake AI team          | For Snowflake to run AI jobs on data in Apache Iceberg&trade; tables. |\n\n### Service connection\n\nA service connection represents a REST-compatible engine (such as Apache Spark&trade;, Apache Flink&reg;, or Trino) that can read from and write to Polaris\nCatalog. When creating a new service connection, the Polaris administrator grants the service principal that is created with the new service \nconnection either a new or existing principal role. A principal role is a resource in Polaris that you can use to logically group Polaris \nservice principals together and grant privileges on securable objects. For more information, see [Principal role](access-control.md#principal-role \"Principal role\"). Polaris uses a role-based access control (RBAC) model to grant service principals access to resources. For more information, \nsee [Access control](access-control.md \"Access control\"). For a diagram of this model, see [RBAC model](access-control.md#rbac-model \"RBAC model\").\n\nIf the Polaris administrator grants the service principal for the new service connection a new principal role, the service principal\ndoesn't have any privileges granted to it yet. When securing the catalog that the new service connection will connect to, the Polaris\nadministrator grants privileges to catalog roles and then grants these catalog roles to the new principal role. As a result, the service\nprincipal for the new service connection has these privileges. For more information about catalog roles, see [Catalog role](access-control.md#catalog-role \"Catalog role\").\n\nIf the Polaris administrator grants an existing principal role to the service principal for the new service connection, the service principal\nhas the same privileges granted to the catalog roles that are granted to the existing principal role. If needed, the Polaris\nadministrator can grant additional catalog roles to the existing principal role or remove catalog roles from it to adjust the privileges\nbestowed to the service principal. For an example of how RBAC works in Polaris, see [RBAC example](access-control.md#rbac-example \"RBAC example\").\n\n### Storage configuration\n\nA storage configuration stores a generated identity and access management (IAM) entity for your external cloud storage and is created\nwhen you create a catalog. The storage configuration is used to set the values to connect Polaris to your cloud storage. During the\ncatalog creation process, an IAM entity is generated and used to create a trust relationship between the cloud storage provider and Polaris\nCatalog.\n\nWhen you create a catalog, you supply the following information about your external cloud storage:\n\n| Cloud storage provider | Information |\n| -----------------------| ----------- |\n| Amazon S3 | <ul><li>Default base location for your Amazon S3 bucket</li><li>Locations for your Amazon S3 bucket</li><li>S3 role ARN</li><li>External ID (optional)</li></ul> |\n| Google Cloud Storage (GCS) | <ul><li>Default base location for your GCS bucket</li><li>Locations for your GCS bucket</li></ul> |\n| Azure | <ul><li>Default base location for your Microsoft Azure container</li><li>Locations for your Microsoft Azure container</li><li>Azure tenant ID</li></ul> |\n\n## Example workflow\n\nIn the following example workflow, Bob creates an Apache Iceberg&trade; table named Table1 and Alice reads data from Table1.\n\n1.  Bob uses Apache Spark&trade; to create the Table1 table under the\n    Namespace1 namespace in the Catalog1 catalog and insert values into\n    Table1.\n\n    Bob can create Table1 and insert data into it because he is using a\n    service connection with a service principal that has\n    the privileges to perform these actions.\n\n2.  Alice uses Snowflake to read data from Table1.\n\n    Alice can read data from Table1 because she is using a service\n    connection with a service principal with a catalog integration that\n    has the privileges to perform this action. Alice\n    creates an unmanaged table in Snowflake to read data from Table1.\n\n![Diagram that shows an example workflow for Apache Polaris (Incubating)](img/example-workflow.svg \"Example workflow for Apache Polaris (Incubating)\")\n\n## Security and access control\n\nThis section describes security and access control.\n\n### Credential vending\n\nTo secure interactions with service connections, Polaris vends temporary storage credentials to the query engine during query\nexecution. These credentials allow the query engine to run the query without requiring access to your external cloud storage for\nIceberg tables. This process is called credential vending.\n\n### Identity and access management (IAM)\n\nPolaris uses the identity and access management (IAM) entity to securely connect to your storage for accessing table data, Iceberg\nmetadata, and manifest files that store the table schema, partitions, and other metadata. Polaris retains the IAM entity for your\nstorage location.\n\n### Access control\n\nPolaris enforces the access control that you configure across all tables registered with the service and governs security for all\nqueries from query engines in a consistent manner.\n\nPolaris uses a role-based access control (RBAC) model that lets you centrally configure access for Polaris service principals to catalogs,\nnamespaces, and tables.\n\nPolaris RBAC uses two different role types to delegate privileges:\n\n- **Principal roles:** Granted to Polaris service principals and\n  analogous to roles in other access control systems that you grant to\n  service principals.\n\n- **Catalog roles:** Configured with certain privileges on Polaris\n  catalog resources and granted to principal roles.\n\nFor more information, see [Access control](access-control.md \"Access control\").\n\n## Legal Notices\n\nApache&reg;, Apache Iceberg&trade;, Apache Spark&trade;, Apache Flink&reg;, and Flink&reg; are either registered trademarks or trademarks of the Apache Software Foundation in the United States and/or other countries.\n","x-displayName":"Overview"},{"name":"Polaris Entities","description":"<!--\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://www.apache.org/licenses/LICENSE-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\nThis page documents various entities that can be managed in Apache Polaris (Incubating).\n\n## Catalog\n\nA catalog is a top-level entity in Polaris that may contain other entities like [namespaces](#namespace) and [tables](#table). These map directly to [Apache Iceberg catalogs](https://iceberg.apache.org/concepts/catalog/).\n\nFor information on managing catalogs with the REST API or for more information on what data can be associated with a catalog, see [the API docs](../regtests/client/python/docs/CreateCatalogRequest.md).\n\n### Storage Type\n\nAll catalogs in Polaris are associated with a _storage type_. Valid Storage Types are `S3`, `Azure`, and `GCS`. The `FILE` type is also additionally available for testing. Each of these types relates to a different storage provider where data within the catalog may reside. Depending on the storage type, various other configurations may be set for a catalog including credentials to be used when accessing data inside the catalog.\n\nFor details on how to use Storage Types in the REST API, see [the API docs](../regtests/client/python/docs/StorageConfigInfo.md).\n\n## Namespace\n\nA namespace is a logical entity that resides within a [catalog](#catalog) and can contain other entities such as [tables](#table) or [views](#view). Some other systems may refer to namespaces as _schemas_ or _databases_.\n\nIn Polaris, namespaces can be nested. For example, `a.b.c.d.e.f.g` is a valid namespace. `b` is said to reside within `a`, and so on.\n\nFor information on managing namespaces with the REST API or for more information on what data can be associated with a namespace, see [the API docs](../regtests/client/python/docs/CreateNamespaceRequest.md).\n\n\n## Table\n\nPolaris tables are entities that map to [Apache Iceberg tables](https://iceberg.apache.org/docs/nightly/configuration/).\n\nFor information on managing tables with the REST API or for more information on what data can be associated with a table, see [the API docs](../regtests/client/python/docs/CreateTableRequest.md).\n\n## View\n\nPolaris views are entities that map to [Apache Iceberg views](https://iceberg.apache.org/view-spec/).\n\nFor information on managing views with the REST API or for more information on what data can be associated with a view, see [the API docs](../regtests/client/python/docs/CreateViewRequest.md).\n\n## Principal\n\nPolaris principals are unique identities that can be used to represent users or services. Each principal may have one or more [principal roles](#principal-role) assigned to it for the purpose of accessing catalogs and the entities within them.\n\nFor information on managing principals with the REST API or for more information on what data can be associated with a principal, see [the API docs](../regtests/client/python/docs/CreatePrincipalRequest.md).\n\n## Principal Role\n\nPolaris principal roles are labels that may be granted to [principals](#principal). Each principal may have one or more principal roles, and the same principal role may be granted to multiple principals. Principal roles may be assigned based on the persona or responsibilities of a given principal, or on how that principal will need to access different entities within Polaris.\n\nFor information on managing principal roles with the REST API or for more information on what data can be associated with a principal role, see [the API docs](../regtests/client/python/docs/CreatePrincipalRoleRequest.md).\n\n\n## Catalog Role\n\nPolaris catalog roles are labels that may be granted to [catalogs](#catalog). Each catalog may have one or more catalog roles, and the same catalog role may be granted to multiple catalogs. Catalog roles may be assigned based on the nature of data that will reside in a catalog, or by the groups of users and services that might need to access that data. \n\nEach catalog role may have multiple [privileges](#privilege) granted to it, and each catalog role can be granted to one or more [principal roles](#principal-role). This is the mechanism by which principals are granted access to entities inside a catalog such as namespaces and tables.\n\n## Privilege\n\nPolaris privileges are granted to [catalog roles](#catalog-role) in order to grant principals with a given principal role some degree of access to catalogs with a given catalog role. When a privilege is granted to a catalog role, any principal roles granted that catalog role receive the privilege. In turn, any principals who are granted that principal role receive it. \n\nA privilege can be scoped to any entity inside a catalog, including the catalog itself.\n\nFor a list of supported privileges for each privilege class, see the API docs:\n* [Table Privileges](../regtests/client/python/docs/TablePrivilege.md)\n* [View Privileges](../regtests/client/python/docs/ViewPrivilege.md)\n* [Namespace Privileges](../regtests/client/python/docs/NamespacePrivilege.md)\n* [Catalog Privileges](../regtests/client/python/docs/CatalogPrivilege.md)\n","x-displayName":"Polaris Entities"},{"name":"Access Control","description":"<!--\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://www.apache.org/licenses/LICENSE-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\nThis section provides information about how access control works for Apache Polaris (Incubating).\n\nPolaris uses a role-based access control (RBAC) model in which the Polaris administrator assigns access privileges to catalog roles\nand then grants access to resources to service principals by assigning catalog roles to principal roles.\n\nThese are the key concepts to understanding access control in Polaris:\n\n- **Securable object**\n- **Principal role**\n- **Catalog role**\n- **Privilege**\n\n## Securable object\n\nA securable object is an object to which access can be granted. Polaris\nhas the following securable objects:\n\n- Catalog\n- Namespace\n- Iceberg table\n- View\n\n## Principal role\n\nA principal role is a resource in Polaris that you can use to logically group Polaris service principals together and grant privileges on\nsecurable objects.\n\nPolaris supports a many-to-one relationship between service principals and principal roles. For example, to grant the same privileges to\nmultiple service principals, you can grant a single principal role to those service principals. A service principal can be granted one\nprincipal role. When registering a service connection, the Polaris administrator specifies the principal role that is granted to the\nservice principal.\n\nYou don't grant privileges directly to a principal role. Instead, you configure object permissions at the catalog role level, and then grant\ncatalog roles to a principal role.\n\nThe following table shows examples of principal roles that you might configure in Polaris:\n\n| Principal role name | Description |\n| -----------------------| ----------- |\n| Data_engineer   | A role that is granted to multiple service principals for running data engineering jobs. |\n| Data_scientist | A role that is granted to multiple service principals for running data science or AI jobs. |\n\n## Catalog role\n\nA catalog role belongs to a particular catalog resource in Polaris and specifies a set of permissions for actions on the catalog or objects\nin the catalog, such as catalog namespaces or tables. You can create one or more catalog roles for a catalog.\n\nYou grant privileges to a catalog role and then grant the catalog role to a principal role to bestow the privileges to one or more service\nprincipals.\n\n> **Note**\n>\n> If you update the privileges bestowed to a service principal, the updates won't take effect for up to one hour. This means that if you\n> revoke or grant some privileges for a catalog, the updated privileges won't take effect on any service principal with access to that catalog\n> for up to one hour.\n\nPolaris also supports a many-to-many relationship between catalog roles and principal roles. You can grant the same catalog role to one or more\nprincipal roles. Likewise, a principal role can be granted to one or more catalog roles.\n\nThe following table displays examples of catalog roles that you might\nconfigure in Polaris:\n\n| Example Catalog role | Description |\n| -----------------------| ----------- |\n| Catalog administrators   | A role that has been granted multiple privileges to emulate full access to the catalog.<br /><br />Principal roles that have been granted this role are permitted to create, alter, read, write, and drop tables in the catalog.  |\n| Catalog readers      | A role that has been granted read-only privileges to tables in the catalog.<br /><br />Principal roles that have been granted this role are allowed to read from tables in the catalog. |\n| Catalog contributor   | A role that has been granted read and write access privileges to all tables that belong to the catalog.<br /><br />Principal roles that have been granted this role are allowed to perform read and write operations on tables in the catalog. |\n\n## RBAC model\n\nThe following diagram illustrates the RBAC model used by Polaris. For each catalog, the Polaris administrator assigns access\nprivileges to catalog roles and then grants service principals access to resources by assigning catalog roles to principal roles. Polaris\nsupports a many-to-one relationship between service principals and principal roles.\n\n![Diagram that shows the RBAC model for Apache Polaris.](img/rbac-model.svg \"Apache Polaris RBAC model\")\n\n## Access control privileges\n\nThis section describes the privileges that are available in the Polaris access control model. Privileges are granted to catalog roles, catalog\nroles are granted to principal roles, and principal roles are granted to service principals to specify the operations that service principals can\nperform on objects in Polaris.\n\n> **Important**\n>\n> You can only grant privileges at the catalog level. Fine-grained access controls are not available. For example, you can grant read \n> privileges to all tables in a catalog but not to an individual table in the catalog.\n\nTo grant the full set of privileges (drop, list, read, write, etc.) on an object, you can use the *full privilege* option.\n\n### Table privileges\n\n| Privilege | Description |\n| --------- | ----------- |\n| TABLE_CREATE | Enables registering a table with the catalog. |\n| TABLE_DROP | Enables dropping a table from the catalog. |\n| TABLE_LIST | Enables listing any tables in the catalog. |\n| TABLE_READ_PROPERTIES | Enables reading [properties](https://iceberg.apache.org/docs/nightly/configuration/#table-properties) of the table. |\n| TABLE_WRITE_PROPERTIES | Enables configuring [properties](https://iceberg.apache.org/docs/nightly/configuration/#table-properties) for the table. |\n| TABLE_READ_DATA | Enables reading data from the table by receiving short-lived read-only storage credentials from the catalog. |\n| TABLE_WRITE_DATA | Enables writing data to the table by receiving short-lived read+write storage credentials from the catalog. |\n| TABLE_FULL_METADATA | Grants all table privileges, except TABLE_READ_DATA and TABLE_WRITE_DATA, which need to be granted individually. |\n\n### View privileges\n\n| Privilege | Description |\n| --------- | ----------- |\n| VIEW_CREATE  | Enables registering a view with the catalog. |\n| VIEW_DROP | Enables dropping a view from the catalog. |\n| VIEW_LIST | Enables listing any views in the catalog.  |\n| VIEW_READ_PROPERTIES | Enables reading all the view properties. |\n| VIEW_WRITE_PROPERTIES | Enables configuring view properties. |\n| VIEW_FULL_METADATA | Grants all view privileges. |\n\n### Namespace privileges\n\n| Privilege | Description |\n| --------- | ----------- |\n| NAMESPACE_CREATE | Enables creating a namespace in a catalog. |\n| NAMESPACE_DROP | Enables dropping the namespace from the catalog. |\n| NAMESPACE_LIST | Enables listing any object in the namespace, including nested namespaces and tables. |\n| NAMESPACE_READ_PROPERTIES | Enables reading all the namespace properties. |\n| NAMESPACE_WRITE_PROPERTIES | Enables configuring namespace properties. |\n| NAMESPACE_FULL_METADATA | Grants all namespace privileges. |\n\n### Catalog privileges\n\n| Privilege | Description |\n| -----------------------| ----------- |\n| CATALOG_MANAGE_ACCESS | Includes the ability to grant or revoke privileges on objects in a catalog to catalog roles, and the ability to grant or revoke catalog roles to or from principal roles. |\n| CATALOG_MANAGE_CONTENT | Enables full management of content for the catalog. This privilege encompasses the following privileges:<ul><li>CATALOG_MANAGE_METADATA</li><li>TABLE_FULL_METADATA</li><li>NAMESPACE_FULL_METADATA</li><li>VIEW_FULL_METADATA</li><li>TABLE_WRITE_DATA</li><li>TABLE_READ_DATA</li><li>CATALOG_READ_PROPERTIES</li><li>CATALOG_WRITE_PROPERTIES</li></ul> |\n| CATALOG_MANAGE_METADATA | Enables full management of the catalog, catalog roles, namespaces, and tables.  |\n| CATALOG_READ_PROPERTIES | Enables listing catalogs and reading properties of the catalog. |\n| CATALOG_WRITE_PROPERTIES | Enables configuring catalog properties. |\n\n## RBAC example\n\nThe following diagram illustrates how RBAC works in Polaris and\nincludes the following users:\n\n- **Alice:** A service admin who signs up for Polaris. Alice can\n    create service principals. She can also create catalogs and\n    namespaces and configure access control for Polaris resources.\n\n- **Bob:** A data engineer who uses Snowpipe Streaming (in Snowflake)\n    and Apache Spark&trade; connections to interact with Polaris.\n\n    - Alice has created a service principal for Bob. It has been\n        granted the Data_engineer principal role, which in turn has been\n        granted the following catalog roles: Catalog contributor and\n        Data administrator (for both the Silver and Gold zone catalogs\n        in the following diagram).\n\n    - The Catalog contributor role grants permission to create\n        namespaces and tables in the Bronze zone catalog.\n\n    - The Data administrator roles grant full administrative rights to\n        the Silver zone catalog and Gold zone catalog.\n\n- **Mark:** A data scientist who uses Snowflake AI services to\n    interact with Polaris.\n\n    - Alice has created a service principal for Mark. It has been\n        granted the Data_scientist principal role, which in turn has\n        been granted the catalog role named Catalog reader.\n\n    - The Catalog reader role grants read-only access for a catalog\n        named Gold zone catalog.\n\n![Diagram that shows an example of how RBAC works in Apache Polaris.](img/rbac-example.svg \"Apache Polaris RBAC example\")\n","x-displayName":"Access Control"},{"name":"Configuring Polaris for Production","description":"<!--\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://www.apache.org/licenses/LICENSE-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\n# Configuring Apache Polaris (Incubating) for Production\n\nThe default `polaris-server.yml` configuration is intended for develoment and testing. When deploying Polaris in production, there are several best practices to keep in mind.\n\n## Security\n\n### Configurations\n\nNotable configuration used to secure a Polaris deployment are outlined below.\n\n#### oauth2\n\n> [!WARNING]  \n> Ensure that the `tokenBroker` setting reflects the token broker specified in `authenticator` below.\n\n* Configure [OAuth](https://oauth.net/2/) with this setting. Remove the `TestInlineBearerTokenPolarisAuthenticator` option and uncomment the `DefaultPolarisAuthenticator` authenticator option beneath it.\n* Then, configure the token broker. You can configure the token broker to use either [asymmetric](https://github.com/apache/polaris/blob/b482617bf8cc508b37dbedf3ebc81a9408160a5e/polaris-service/src/main/java/io/polaris/service/auth/JWTRSAKeyPair.java#L24) or [symmetric](https://github.com/apache/polaris/blob/b482617bf8cc508b37dbedf3ebc81a9408160a5e/polaris-service/src/main/java/io/polaris/service/auth/JWTSymmetricKeyBroker.java#L23) keys.\n\n#### authenticator.tokenBroker\n\n> [!WARNING]  \n> Ensure that the `tokenBroker` setting reflects the token broker specified in `oauth2` above.\n\n#### callContextResolver & realmContextResolver\n* Use these configurations to specify a service that can resolve a realm from bearer tokens.\n* The service(s) used here must implement the relevant interfaces (i.e. [CallContextResolver](https://github.com/apache/polaris/blob/8290019c10290a600e40b35ddb1e2f54bf99e120/polaris-service/src/main/java/io/polaris/service/context/CallContextResolver.java#L27) and [RealmContextResolver](https://github.com/apache/polaris/blob/7ce86f10a68a3b56aed766235c88d6027c0de038/polaris-service/src/main/java/io/polaris/service/context/RealmContextResolver.java)).\n\n## Metastore Management\n\n> [!IMPORTANT]  \n> The default `in-memory` implementation for `metastoreManager` is meant for testing and not suitable for production usage. Instead, consider an implementation such as `eclipse-link` which allows you to store metadata in a remote database.\n\nA Metastore Manger should be configured with an implementation that durably persists Polaris entities. Use the configuration `metaStoreManager` to configure a [MetastoreManager](https://github.com/apache/polaris/blob/627dc602eb15a3258dcc32babf8def34cf6de0e9/polaris-core/src/main/java/io/polaris/core/persistence/PolarisMetaStoreManager.java#L47) implementation where Polaris entities will be persisted. \n\nBe sure to secure your metastore backend since it will be storing credentials and catalog metadata.\n\n### Configuring EclipseLink\n\nTo use [EclipseLink](https://eclipse.dev/eclipselink/) for metastore management, specify the configuration `metaStoreManager.conf-file` to point to an [EclipseLink `persistence.xml` file](https://eclipse.dev/eclipselink/documentation/2.5/solutions/testingjpa002.htm). This file, local to the Polaris service, will contain information on what database to use for metastore management and how to connect to it.\n\n### Bootstrapping\n\nBefore using Polaris when using a metastore manager other than `in-memory`, you must **bootstrap** the metastore manager. This is a manual operation that must be performed **only once** in order to prepare the metastore manager to integrate with Polaris. When the metastore manager is bootstrapped, any existing Polaris entities in the metastore manager may be **purged**.\n\nTo bootstrap Polaris, run:\n\n```bash\njava -jar /path/to/jar/polaris-service-all.jar bootstrap polaris-server.yml\n```\n\nAfterwards, Polaris can be launched normally:\n\n```bash\njava -jar /path/to/jar/polaris-service-all.jar server polaris-server.yml\n```\n\n## Other Configurations\n\nWhen deploying Polaris in production, consider adjusting the following configurations:\n\n#### featureConfiguration.SUPPORTED_CATALOG_STORAGE_TYPES\n  - By default Polaris catalogs are allowed to be located in local filesystem with the `FILE` storage type. This should be disabled for production systems.\n  - Use this configuration to additionally disable any other storage types that will not be in use.\n\n\n","x-displayName":"Configuring Polaris for Production"},{"name":"polaris-management-service_other","x-displayName":"other"},{"name":"Configuration API","x-displayName":"Configuration API"},{"name":"OAuth2 API","x-displayName":"OAuth2 API"},{"name":"Catalog API","x-displayName":"Catalog API"}],"paths":{"/catalogs":{"get":{"operationId":"listCatalogs","description":"List all catalogs in this polaris service","responses":{"200":{"description":"List of catalogs in the polaris service","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_Catalogs"}}}},"403":{"description":"The caller does not have permission to list catalog details"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]},"post":{"operationId":"createCatalog","description":"Add a new Catalog","requestBody":{"description":"The Catalog to create","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_CreateCatalogRequest"}}}},"responses":{"201":{"description":"Successful response"},"403":{"description":"The caller does not have permission to create a catalog"},"404":{"description":"The catalog does not exist"},"409":{"description":"A catalog with the specified name already exists"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]}},"/catalogs/{catalogName}":{"parameters":[{"name":"catalogName","in":"path","description":"The name of the catalog","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"}}],"get":{"operationId":"getCatalog","description":"Get the details of a catalog","responses":{"200":{"description":"The catalog details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_Catalog"}}}},"403":{"description":"The caller does not have permission to read catalog details"},"404":{"description":"The catalog does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]},"put":{"operationId":"updateCatalog","description":"Update an existing catalog","requestBody":{"description":"The catalog details to use in the update","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_UpdateCatalogRequest"}}}},"responses":{"200":{"description":"The catalog details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_Catalog"}}}},"403":{"description":"The caller does not have permission to update catalog details"},"404":{"description":"The catalog does not exist"},"409":{"description":"The entity version doesn't match the currentEntityVersion; retry after fetching latest version"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]},"delete":{"operationId":"deleteCatalog","description":"Delete an existing catalog. This is a cascading operation that deletes all metadata, including principals, roles and grants. If the catalog is an internal catalog, all tables and namespaces are dropped without purge.","responses":{"204":{"description":"Success, no content"},"403":{"description":"The caller does not have permission to delete a catalog"},"404":{"description":"The catalog does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]}},"/principals":{"get":{"operationId":"listPrincipals","description":"List the principals for the current catalog","responses":{"200":{"description":"List of principals for this catalog","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_Principals"}}}},"403":{"description":"The caller does not have permission to list catalog admins"},"404":{"description":"The catalog does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]},"post":{"operationId":"createPrincipal","description":"Create a principal","requestBody":{"description":"The principal to create","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_CreatePrincipalRequest"}}}},"responses":{"201":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_PrincipalWithCredentials"}}}},"403":{"description":"The caller does not have permission to add a principal"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]}},"/principals/{principalName}":{"parameters":[{"name":"principalName","in":"path","description":"The principal name","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"}}],"get":{"operationId":"getPrincipal","description":"Get the principal details","responses":{"200":{"description":"The requested principal","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_Principal"}}}},"403":{"description":"The caller does not have permission to get principal details"},"404":{"description":"The catalog or principal does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]},"put":{"operationId":"updatePrincipal","description":"Update an existing principal","requestBody":{"description":"The principal details to use in the update","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_UpdatePrincipalRequest"}}}},"responses":{"200":{"description":"The updated principal","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_Principal"}}}},"403":{"description":"The caller does not have permission to update principal details"},"404":{"description":"The principal does not exist"},"409":{"description":"The entity version doesn't match the currentEntityVersion; retry after fetching latest version"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]},"delete":{"operationId":"deletePrincipal","description":"Remove a principal from polaris","responses":{"204":{"description":"Success, no content"},"403":{"description":"The caller does not have permission to delete a principal"},"404":{"description":"The principal does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]}},"/principals/{principalName}/rotate":{"parameters":[{"name":"principalName","in":"path","description":"The user name","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"}}],"post":{"operationId":"rotateCredentials","description":"Rotate a principal's credentials. The new credentials will be returned in the response. This is the only API, aside from createPrincipal, that returns the user's credentials. This API is *not* idempotent.","responses":{"200":{"description":"The principal details along with the newly rotated credentials","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_PrincipalWithCredentials"}}}},"403":{"description":"The caller does not have permission to rotate credentials"},"404":{"description":"The principal does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]}},"/principals/{principalName}/principal-roles":{"parameters":[{"name":"principalName","in":"path","description":"The name of the target principal","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"}}],"get":{"operationId":"listPrincipalRolesAssigned","description":"List the roles assigned to the principal","responses":{"200":{"description":"List of roles assigned to this principal","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_PrincipalRoles"}}}},"403":{"description":"The caller does not have permission to list roles"},"404":{"description":"The principal or catalog does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]},"put":{"operationId":"assignPrincipalRole","description":"Add a role to the principal","requestBody":{"description":"The principal role to assign","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_GrantPrincipalRoleRequest"}}}},"responses":{"201":{"description":"Successful response"},"403":{"description":"The caller does not have permission to add assign a role to the principal"},"404":{"description":"The catalog, the principal, or the role does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]}},"/principals/{principalName}/principal-roles/{principalRoleName}":{"parameters":[{"name":"principalName","in":"path","description":"The name of the target principal","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"}},{"name":"principalRoleName","in":"path","description":"The name of the role","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"}}],"delete":{"operationId":"revokePrincipalRole","description":"Remove a role from a catalog principal","responses":{"204":{"description":"Success, no content"},"403":{"description":"The caller does not have permission to remove a role from the principal"},"404":{"description":"The catalog or principal does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]}},"/principal-roles":{"get":{"operationId":"listPrincipalRoles","description":"List the principal roles","responses":{"200":{"description":"List of principal roles","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_PrincipalRoles"}}}},"403":{"description":"The caller does not have permission to list principal roles"},"404":{"description":"The catalog does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]},"post":{"operationId":"createPrincipalRole","description":"Create a principal role","requestBody":{"description":"The principal to create","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_CreatePrincipalRoleRequest"}}}},"responses":{"201":{"description":"Successful response"},"403":{"description":"The caller does not have permission to add a principal role"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]}},"/principal-roles/{principalRoleName}":{"parameters":[{"name":"principalRoleName","in":"path","description":"The principal role name","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"}}],"get":{"operationId":"getPrincipalRole","description":"Get the principal role details","responses":{"200":{"description":"The requested principal role","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_PrincipalRole"}}}},"403":{"description":"The caller does not have permission to get principal role details"},"404":{"description":"The principal role does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]},"put":{"operationId":"updatePrincipalRole","description":"Update an existing principalRole","requestBody":{"description":"The principalRole details to use in the update","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_UpdatePrincipalRoleRequest"}}}},"responses":{"200":{"description":"The updated principal role","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_PrincipalRole"}}}},"403":{"description":"The caller does not have permission to update principal role details"},"404":{"description":"The principal role does not exist"},"409":{"description":"The entity version doesn't match the currentEntityVersion; retry after fetching latest version"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]},"delete":{"operationId":"deletePrincipalRole","description":"Remove a principal role from polaris","responses":{"204":{"description":"Success, no content"},"403":{"description":"The caller does not have permission to delete a principal role"},"404":{"description":"The principal role does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]}},"/principal-roles/{principalRoleName}/principals":{"parameters":[{"name":"principalRoleName","in":"path","description":"The principal role name","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"}}],"get":{"operationId":"listAssigneePrincipalsForPrincipalRole","description":"List the Principals to whom the target principal role has been assigned","responses":{"200":{"description":"List the Principals to whom the target principal role has been assigned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_Principals"}}}},"403":{"description":"The caller does not have permission to list principals"},"404":{"description":"The principal role does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]}},"/principal-roles/{principalRoleName}/catalog-roles/{catalogName}":{"parameters":[{"name":"principalRoleName","in":"path","description":"The principal role name","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"}},{"name":"catalogName","in":"path","required":true,"description":"The name of the catalog where the catalogRoles reside","schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"}}],"get":{"operationId":"listCatalogRolesForPrincipalRole","description":"Get the catalog roles mapped to the principal role","responses":{"200":{"description":"The list of catalog roles mapped to the principal role","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_CatalogRoles"}}}},"403":{"description":"The caller does not have permission to list catalog roles"},"404":{"description":"The principal role does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]},"put":{"operationId":"assignCatalogRoleToPrincipalRole","description":"Assign a catalog role to a principal role","requestBody":{"description":"The principal to create","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_GrantCatalogRoleRequest"}}}},"responses":{"201":{"description":"Successful response"},"403":{"description":"The caller does not have permission to assign a catalog role"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]}},"/principal-roles/{principalRoleName}/catalog-roles/{catalogName}/{catalogRoleName}":{"parameters":[{"name":"principalRoleName","in":"path","description":"The principal role name","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"}},{"name":"catalogName","in":"path","description":"The name of the catalog that contains the role to revoke","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"}},{"name":"catalogRoleName","in":"path","description":"The name of the catalog role that should be revoked","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"}}],"delete":{"operationId":"revokeCatalogRoleFromPrincipalRole","description":"Remove a catalog role from a principal role","responses":{"204":{"description":"Success, no content"},"403":{"description":"The caller does not have permission to revoke a catalog role"},"404":{"description":"The principal role does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]}},"/catalogs/{catalogName}/catalog-roles":{"parameters":[{"name":"catalogName","in":"path","description":"The catalog for which we are reading/updating roles","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"}}],"get":{"operationId":"listCatalogRoles","description":"List existing roles in the catalog","responses":{"200":{"description":"The list of roles that exist in this catalog","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_CatalogRoles"}}}}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]},"post":{"operationId":"createCatalogRole","description":"Create a new role in the catalog","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_CreateCatalogRoleRequest"}}}},"responses":{"201":{"description":"Successful response"},"403":{"description":"The principal is not authorized to create roles"},"404":{"description":"The catalog does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]}},"/catalogs/{catalogName}/catalog-roles/{catalogRoleName}":{"parameters":[{"name":"catalogName","in":"path","description":"The catalog for which we are retrieving roles","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"}},{"name":"catalogRoleName","in":"path","description":"The name of the role","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"}}],"get":{"operationId":"getCatalogRole","description":"Get the details of an existing role","responses":{"200":{"description":"The specified role details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_CatalogRole"}}}},"403":{"description":"The principal is not authorized to read role data"},"404":{"description":"The catalog or the role does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]},"put":{"operationId":"updateCatalogRole","description":"Update an existing role in the catalog","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_UpdateCatalogRoleRequest"}}}},"responses":{"200":{"description":"The specified role details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_CatalogRole"}}}},"403":{"description":"The principal is not authorized to update roles"},"404":{"description":"The catalog or the role does not exist"},"409":{"description":"The entity version doesn't match the currentEntityVersion; retry after fetching latest version"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]},"delete":{"operationId":"deleteCatalogRole","description":"Delete an existing role from the catalog. All associated grants will also be deleted","responses":{"204":{"description":"Success, no content"},"403":{"description":"The principal is not authorized to delete roles"},"404":{"description":"The catalog or the role does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]}},"/catalogs/{catalogName}/catalog-roles/{catalogRoleName}/principal-roles":{"parameters":[{"name":"catalogName","in":"path","required":true,"description":"The name of the catalog where the catalog role resides","schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"}},{"name":"catalogRoleName","in":"path","required":true,"description":"The name of the catalog role","schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"}}],"get":{"operationId":"listAssigneePrincipalRolesForCatalogRole","description":"List the PrincipalRoles to which the target catalog role has been assigned","responses":{"200":{"description":"List the PrincipalRoles to which the target catalog role has been assigned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_PrincipalRoles"}}}},"403":{"description":"The caller does not have permission to list principal roles"},"404":{"description":"The catalog or catalog role does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]}},"/catalogs/{catalogName}/catalog-roles/{catalogRoleName}/grants":{"parameters":[{"name":"catalogName","in":"path","required":true,"description":"The name of the catalog where the role will receive the grant","schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"}},{"name":"catalogRoleName","in":"path","required":true,"description":"The name of the role receiving the grant (must exist)","schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"}}],"get":{"operationId":"listGrantsForCatalogRole","description":"List the grants the catalog role holds","responses":{"200":{"description":"List of all grants given to the role in this catalog","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_GrantResources"}}}}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]},"put":{"operationId":"addGrantToCatalogRole","description":"Add a new grant to the catalog role","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_AddGrantRequest"}}}},"responses":{"201":{"description":"Successful response"},"403":{"description":"The principal is not authorized to create grants"},"404":{"description":"The catalog or the role does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]},"post":{"operationId":"revokeGrantFromCatalogRole","description":"Delete a specific grant from the role. This may be a subset or a superset of the grants the role has. In case of a subset, the role will retain the grants not specified. If the `cascade` parameter is true, grant revocation will have a cascading effect - that is, if a principal has specific grants on a subresource, and grants are revoked on a parent resource, the grants present on the subresource will be revoked as well. By default, this behavior is disabled and grant revocation only affects the specified resource.","parameters":[{"name":"cascade","in":"query","schema":{"type":"boolean","default":false},"description":"If true, the grant revocation cascades to all subresources."}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_RevokeGrantRequest"}}}},"responses":{"201":{"description":"Successful response"},"403":{"description":"The principal is not authorized to create grants"},"404":{"description":"The catalog or the role does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]}},"/v1/config":{"get":{"tags":["Configuration API"],"summary":"List all catalog configuration settings","operationId":"getConfig","parameters":[{"name":"warehouse","in":"query","required":false,"schema":{"type":"string"},"description":"Warehouse location or identifier to request from the service"}],"description":" All REST clients should first call this route to get catalog configuration properties from the server to configure the catalog and its HTTP client. Configuration from the server consists of two sets of key/value pairs.\n- defaults -  properties that should be used as default configuration; applied before client configuration\n- overrides - properties that should be used to override client configuration; applied after defaults and client configuration\n\nCatalog configuration is constructed by setting the defaults, then client- provided configuration, and finally overrides. The final property set is then used to configure the catalog.\n\nFor example, a default configuration property might set the size of the client pool, which can be replaced with a client-specific setting. An override might be used to set the warehouse location, which is stored on the server rather than in client configuration.\n\nCommon catalog configuration settings are documented at https://iceberg.apache.org/docs/latest/configuration/#catalog-properties ","responses":{"200":{"description":"Server specified configuration values.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_CatalogConfig"},"example":{"overrides":{"warehouse":"s3://bucket/warehouse/"},"defaults":{"clients":"4"}}}}},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]}},"/v1/oauth/tokens":{"post":{"tags":["OAuth2 API"],"summary":"Get a token using an OAuth2 flow","operationId":"getToken","description":"Exchange credentials for a token using the OAuth2 client credentials flow or token exchange.\n\nThis endpoint is used for three purposes -\n1. To exchange client credentials (client ID and secret) for an access token This uses the client credentials flow.\n2. To exchange a client token and an identity token for a more specific access token This uses the token exchange flow.\n3. To exchange an access token for one with the same claims and a refreshed expiration period This uses the token exchange flow.\n\nFor example, a catalog client may be configured with client credentials from the OAuth2 Authorization flow. This client would exchange its client ID and secret for an access token using the client credentials request with this endpoint (1). Subsequent requests would then use that access token.\n\nSome clients may also handle sessions that have additional user context. These clients would use the token exchange flow to exchange a user token (the \"subject\" token) from the session for a more specific access token for that user, using the catalog's access token as the \"actor\" token (2). The user ID token is the \"subject\" token and can be any token type allowed by the OAuth2 token exchange flow, including a unsecured JWT token with a sub claim. This request should use the catalog's bearer token in the \"Authorization\" header.\n\nClients may also use the token exchange flow to refresh a token that is about to expire by sending a token exchange request (3). The request's \"subject\" token should be the expiring token. This request should use the subject token in the \"Authorization\" header.","parameters":[{"name":"Authorization","in":"header","schema":{"type":"string"},"required":false}],"requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_OAuthTokenRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_OAuthTokenResponse"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_OAuthErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_OAuthErrorResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_OAuthErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]}},"/v1/{prefix}/namespaces":{"parameters":[{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_prefix"}],"get":{"tags":["Catalog API"],"summary":"List namespaces, optionally providing a parent namespace to list underneath","description":"List all namespaces at a certain level, optionally starting from a given parent namespace. If table accounting.tax.paid.info exists, using 'SELECT NAMESPACE IN accounting' would translate into `GET /namespaces?parent=accounting` and must return a namespace, [\"accounting\", \"tax\"] only. Using 'SELECT NAMESPACE IN accounting.tax' would translate into `GET /namespaces?parent=accounting%1Ftax` and must return a namespace, [\"accounting\", \"tax\", \"paid\"]. If `parent` is not provided, all top-level namespaces should be listed.","operationId":"listNamespaces","parameters":[{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_page-token"},{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_page-size"},{"name":"parent","in":"query","description":"An optional namespace, underneath which to list namespaces. If not provided or empty, all top-level namespaces should be listed. If parent is a multipart namespace, the parts must be separated by the unit separator (`0x1F`) byte.","required":false,"allowEmptyValue":true,"schema":{"type":"string"},"example":"accounting%1Ftax"}],"responses":{"200":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ListNamespacesResponse"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - Namespace provided in the `parent` query parameter is not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"examples":{"NoSuchNamespaceExample":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchNamespaceError"}}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]},"post":{"tags":["Catalog API"],"summary":"Create a namespace","description":"Create a namespace, with an optional set of properties. The server might also add properties, such as `last_modified_time` etc.","operationId":"createNamespace","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_CreateNamespaceRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_CreateNamespaceResponse"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"406":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnsupportedOperationResponse"},"409":{"description":"Conflict - The namespace already exists","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"examples":{"NamespaceAlreadyExists":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NamespaceAlreadyExistsError"}}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]}},"/v1/{prefix}/namespaces/{namespace}":{"parameters":[{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_prefix"},{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_namespace"}],"get":{"tags":["Catalog API"],"summary":"Load the metadata properties for a namespace","operationId":"loadNamespaceMetadata","description":"Return all stored metadata properties for a given namespace","responses":{"200":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_GetNamespaceResponse"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - Namespace not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"examples":{"NoSuchNamespaceExample":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchNamespaceError"}}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]},"head":{"tags":["Catalog API"],"summary":"Check if a namespace exists","operationId":"namespaceExists","description":"Check if a namespace exists. The response does not contain a body.","responses":{"204":{"description":"Success, no content"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - Namespace not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"examples":{"NoSuchNamespaceExample":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchNamespaceError"}}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]},"delete":{"tags":["Catalog API"],"summary":"Drop a namespace from the catalog. Namespace must be empty.","operationId":"dropNamespace","responses":{"204":{"description":"Success, no content"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - Namespace to delete does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"examples":{"NoSuchNamespaceExample":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchNamespaceError"}}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]}},"/v1/{prefix}/namespaces/{namespace}/properties":{"parameters":[{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_prefix"},{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_namespace"}],"post":{"tags":["Catalog API"],"summary":"Set or remove properties on a namespace","operationId":"updateProperties","description":"Set and/or remove properties on a namespace. The request body specifies a list of properties to remove and a map of key value pairs to update.\nProperties that are not in the request are not modified or removed by this call.\nServer implementations are not required to support namespace properties.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_UpdateNamespacePropertiesRequest"},"examples":{"UpdateAndRemoveProperties":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_UpdateAndRemoveNamespacePropertiesRequest"}}}}},"responses":{"200":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UpdateNamespacePropertiesResponse"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - Namespace not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"examples":{"NamespaceNotFound":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchNamespaceError"}}}}},"406":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnsupportedOperationResponse"},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"422":{"description":"Unprocessable Entity - A property key was included in both `removals` and `updates`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"examples":{"UnprocessableEntityDuplicateKey":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_UnprocessableEntityDuplicateKey"}}}}},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]}},"/v1/{prefix}/namespaces/{namespace}/tables":{"parameters":[{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_prefix"},{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_namespace"}],"get":{"tags":["Catalog API"],"summary":"List all table identifiers underneath a given namespace","description":"Return all table identifiers under this namespace","operationId":"listTables","parameters":[{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_page-token"},{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_page-size"}],"responses":{"200":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ListTablesResponse"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - The namespace specified does not exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"examples":{"NamespaceNotFound":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchNamespaceError"}}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]},"post":{"tags":["Catalog API"],"summary":"Create a table in the given namespace","description":"Create a table or start a create transaction, like atomic CTAS.\n\nIf `stage-create` is false, the table is created immediately.\n\nIf `stage-create` is true, the table is not created, but table metadata is initialized and returned. The service should prepare as needed for a commit to the table commit endpoint to complete the create transaction. The client uses the returned metadata to begin a transaction. To commit the transaction, the client sends all create and subsequent changes to the table commit route. Changes from the table create operation include changes like AddSchemaUpdate and SetCurrentSchemaUpdate that set the initial table state.","operationId":"createTable","parameters":[{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_data-access"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_CreateTableRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_CreateTableResponse"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - The namespace specified does not exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"examples":{"NamespaceNotFound":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchNamespaceError"}}}}},"409":{"description":"Conflict - The table already exists","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"examples":{"NamespaceAlreadyExists":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_TableAlreadyExistsError"}}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]}},"/v1/{prefix}/namespaces/{namespace}/register":{"parameters":[{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_prefix"},{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_namespace"}],"post":{"tags":["Catalog API"],"summary":"Register a table in the given namespace using given metadata file location","description":"Register a table using given metadata file location.","operationId":"registerTable","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_RegisterTableRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_LoadTableResponse"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - The namespace specified does not exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"examples":{"NamespaceNotFound":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchNamespaceError"}}}}},"409":{"description":"Conflict - The table already exists","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"examples":{"NamespaceAlreadyExists":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_TableAlreadyExistsError"}}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]}},"/v1/{prefix}/namespaces/{namespace}/tables/{table}":{"parameters":[{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_prefix"},{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_namespace"},{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_table"}],"get":{"tags":["Catalog API"],"summary":"Load a table from the catalog","operationId":"loadTable","description":"Load a table from the catalog.\n\nThe response contains both configuration and table metadata. The configuration, if non-empty is used as additional configuration for the table that overrides catalog configuration. For example, this configuration may change the FileIO implementation to be used for the table.\n\nThe response also contains the table's full metadata, matching the table metadata JSON file.\n\nThe catalog configuration may contain credentials that should be used for subsequent requests for the table. The configuration key \"token\" is used to pass an access token to be used as a bearer token for table requests. Otherwise, a token may be passed using a RFC 8693 token type as a configuration key. For example, \"urn:ietf:params:oauth:token-type:jwt=<JWT-token>\".","parameters":[{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_data-access"},{"in":"query","name":"snapshots","description":"The snapshots to return in the body of the metadata. Setting the value to `all` would return the full set of snapshots currently valid for the table. Setting the value to `refs` would load all snapshots referenced by branches or tags.\nDefault if no param is provided is `all`.","required":false,"schema":{"type":"string","enum":["all","refs"]}}],"responses":{"200":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_LoadTableResponse"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - NoSuchTableException, table to load does not exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"examples":{"TableToLoadDoesNotExist":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchTableError"}}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]},"post":{"tags":["Catalog API"],"summary":"Commit updates to a table","operationId":"updateTable","description":"Commit updates to a table.\n\nCommits have two parts, requirements and updates. Requirements are assertions that will be validated before attempting to make and commit changes. For example, `assert-ref-snapshot-id` will check that a named ref's snapshot ID has a certain value.\n\nUpdates are changes to make to table metadata. For example, after asserting that the current main ref is at the expected snapshot, a commit may add a new child snapshot and set the ref to the new snapshot id.\n\nCreate table transactions that are started by createTable with `stage-create` set to true are committed using this route. Transactions should include all changes to the table, including table initialization, like AddSchemaUpdate and SetCurrentSchemaUpdate. The `assert-create` requirement is used to ensure that the table was not created concurrently.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_CommitTableRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_CommitTableResponse"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - NoSuchTableException, table to load does not exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"examples":{"TableToUpdateDoesNotExist":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchTableError"}}}}},"409":{"description":"Conflict - CommitFailedException, one or more requirements failed. The client may retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"500":{"description":"An unknown server-side problem occurred; the commit state is unknown.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"example":{"error":{"message":"Internal Server Error","type":"CommitStateUnknownException","code":500}}}}},"502":{"description":"A gateway or proxy received an invalid response from the upstream server; the commit state is unknown.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"example":{"error":{"message":"Invalid response from the upstream server","type":"CommitStateUnknownException","code":502}}}}},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"504":{"description":"A server-side gateway timeout occurred; the commit state is unknown.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"example":{"error":{"message":"Gateway timed out during commit","type":"CommitStateUnknownException","code":504}}}}},"5XX":{"description":"A server-side problem that might not be addressable on the client.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"example":{"error":{"message":"Bad Gateway","type":"InternalServerError","code":502}}}}}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]},"delete":{"tags":["Catalog API"],"summary":"Drop a table from the catalog","operationId":"dropTable","description":"Remove a table from the catalog","parameters":[{"name":"purgeRequested","in":"query","required":false,"description":"Whether the user requested to purge the underlying table's data and metadata","schema":{"type":"boolean","default":false}}],"responses":{"204":{"description":"Success, no content"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - NoSuchTableException, Table to drop does not exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"examples":{"TableToDeleteDoesNotExist":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchTableError"}}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]},"head":{"tags":["Catalog API"],"summary":"Check if a table exists","operationId":"tableExists","description":"Check if a table exists within a given namespace. The response does not contain a body.","responses":{"204":{"description":"Success, no content"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - NoSuchTableException, Table not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"examples":{"TableToLoadDoesNotExist":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchTableError"}}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]}},"/v1/{prefix}/tables/rename":{"parameters":[{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_prefix"}],"post":{"tags":["Catalog API"],"summary":"Rename a table from its current name to a new name","description":"Rename a table from one identifier to another. It's valid to move a table across namespaces, but the server implementation is not required to support it.","operationId":"renameTable","requestBody":{"description":"Current table identifier to rename and new table identifier to rename to","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_RenameTableRequest"},"examples":{"RenameTableSameNamespace":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_RenameTableSameNamespace"}}}},"required":true},"responses":{"204":{"description":"Success, no content"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - NoSuchTableException, Table to rename does not exist - NoSuchNamespaceException, The target namespace of the new table identifier does not exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"examples":{"TableToRenameDoesNotExist":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchTableError"},"NamespaceToRenameToDoesNotExist":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchNamespaceError"}}}}},"406":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnsupportedOperationResponse"},"409":{"description":"Conflict - The target identifier to rename to already exists as a table or view","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"example":{"summary":"The requested table identifier already exists","value":{"error":{"message":"The given table already exists","type":"AlreadyExistsException","code":409}}}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]}},"/v1/{prefix}/namespaces/{namespace}/tables/{table}/metrics":{"parameters":[{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_prefix"},{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_namespace"},{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_table"}],"post":{"tags":["Catalog API"],"summary":"Send a metrics report to this endpoint to be processed by the backend","operationId":"reportMetrics","requestBody":{"description":"The request containing the metrics report to be sent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ReportMetricsRequest"}}},"required":true},"responses":{"204":{"description":"Success, no content"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - NoSuchTableException, table to load does not exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"examples":{"TableToLoadDoesNotExist":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchTableError"}}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]}},"/v1/{prefix}/namespaces/{namespace}/tables/{table}/notifications":{"parameters":[{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_prefix"},{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_namespace"},{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_table"}],"post":{"tags":["Catalog API"],"summary":"Sends a notification to the table","operationId":"sendNotification","requestBody":{"description":"The request containing the notification to be sent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_NotificationRequest"}}},"required":true},"responses":{"204":{"description":"Success, no content"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - NoSuchTableException, table to load does not exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"examples":{"TableToLoadDoesNotExist":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchTableError"}}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]}},"/v1/{prefix}/transactions/commit":{"parameters":[{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_prefix"}],"post":{"tags":["Catalog API"],"summary":"Commit updates to multiple tables in an atomic operation","operationId":"commitTransaction","requestBody":{"description":"Commit updates to multiple tables in an atomic operation\n\nA commit for a single table consists of a table identifier with requirements and updates. Requirements are assertions that will be validated before attempting to make and commit changes. For example, `assert-ref-snapshot-id` will check that a named ref's snapshot ID has a certain value.\n\nUpdates are changes to make to table metadata. For example, after asserting that the current main ref is at the expected snapshot, a commit may add a new child snapshot and set the ref to the new snapshot id.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_CommitTransactionRequest"}}},"required":true},"responses":{"204":{"description":"Success, no content"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - NoSuchTableException, table to load does not exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"examples":{"TableToUpdateDoesNotExist":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchTableError"}}}}},"409":{"description":"Conflict - CommitFailedException, one or more requirements failed. The client may retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"500":{"description":"An unknown server-side problem occurred; the commit state is unknown.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"example":{"error":{"message":"Internal Server Error","type":"CommitStateUnknownException","code":500}}}}},"502":{"description":"A gateway or proxy received an invalid response from the upstream server; the commit state is unknown.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"example":{"error":{"message":"Invalid response from the upstream server","type":"CommitStateUnknownException","code":502}}}}},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"504":{"description":"A server-side gateway timeout occurred; the commit state is unknown.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"example":{"error":{"message":"Gateway timed out during commit","type":"CommitStateUnknownException","code":504}}}}},"5XX":{"description":"A server-side problem that might not be addressable on the client.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"example":{"error":{"message":"Bad Gateway","type":"InternalServerError","code":502}}}}}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]}},"/v1/{prefix}/namespaces/{namespace}/views":{"parameters":[{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_prefix"},{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_namespace"}],"get":{"tags":["Catalog API"],"summary":"List all view identifiers underneath a given namespace","description":"Return all view identifiers under this namespace","operationId":"listViews","parameters":[{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_page-token"},{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_page-size"}],"responses":{"200":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ListTablesResponse"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - The namespace specified does not exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ErrorModel"},"examples":{"NamespaceNotFound":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchNamespaceError"}}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]},"post":{"tags":["Catalog API"],"summary":"Create a view in the given namespace","description":"Create a view in the given namespace.","operationId":"createView","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_CreateViewRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_LoadViewResponse"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - The namespace specified does not exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ErrorModel"},"examples":{"NamespaceNotFound":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchNamespaceError"}}}}},"409":{"description":"Conflict - The view already exists","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ErrorModel"},"examples":{"NamespaceAlreadyExists":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_ViewAlreadyExistsError"}}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]}},"/v1/{prefix}/namespaces/{namespace}/views/{view}":{"parameters":[{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_prefix"},{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_namespace"},{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_view"}],"get":{"tags":["Catalog API"],"summary":"Load a view from the catalog","operationId":"loadView","description":"Load a view from the catalog.\n\nThe response contains both configuration and view metadata. The configuration, if non-empty is used as additional configuration for the view that overrides catalog configuration.\n\nThe response also contains the view's full metadata, matching the view metadata JSON file.\n\nThe catalog configuration may contain credentials that should be used for subsequent requests for the view. The configuration key \"token\" is used to pass an access token to be used as a bearer token for view requests. Otherwise, a token may be passed using a RFC 8693 token type as a configuration key. For example, \"urn:ietf:params:oauth:token-type:jwt=<JWT-token>\".","responses":{"200":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_LoadViewResponse"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - NoSuchViewException, view to load does not exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ErrorModel"},"examples":{"ViewToLoadDoesNotExist":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchViewError"}}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]},"post":{"tags":["Catalog API"],"summary":"Replace a view","operationId":"replaceView","description":"Commit updates to a view.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_CommitViewRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_LoadViewResponse"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - NoSuchViewException, view to load does not exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ErrorModel"},"examples":{"ViewToUpdateDoesNotExist":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchViewError"}}}}},"409":{"description":"Conflict - CommitFailedException. The client may retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ErrorModel"}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"500":{"description":"An unknown server-side problem occurred; the commit state is unknown.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ErrorModel"},"example":{"error":{"message":"Internal Server Error","type":"CommitStateUnknownException","code":500}}}}},"502":{"description":"A gateway or proxy received an invalid response from the upstream server; the commit state is unknown.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ErrorModel"},"example":{"error":{"message":"Invalid response from the upstream server","type":"CommitStateUnknownException","code":502}}}}},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"504":{"description":"A server-side gateway timeout occurred; the commit state is unknown.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ErrorModel"},"example":{"error":{"message":"Gateway timed out during commit","type":"CommitStateUnknownException","code":504}}}}},"5XX":{"description":"A server-side problem that might not be addressable on the client.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ErrorModel"},"example":{"error":{"message":"Bad Gateway","type":"InternalServerError","code":502}}}}}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]},"delete":{"tags":["Catalog API"],"summary":"Drop a view from the catalog","operationId":"dropView","description":"Remove a view from the catalog","responses":{"204":{"description":"Success, no content"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - NoSuchViewException, view to drop does not exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ErrorModel"},"examples":{"ViewToDeleteDoesNotExist":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchViewError"}}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]},"head":{"tags":["Catalog API"],"summary":"Check if a view exists","operationId":"viewExists","description":"Check if a view exists within a given namespace. This request does not return a response body.","responses":{"204":{"description":"Success, no content"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"404":{"description":"Not Found"},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]}},"/v1/{prefix}/views/rename":{"parameters":[{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_prefix"}],"post":{"tags":["Catalog API"],"summary":"Rename a view from its current name to a new name","description":"Rename a view from one identifier to another. It's valid to move a view across namespaces, but the server implementation is not required to support it.","operationId":"renameView","requestBody":{"description":"Current view identifier to rename and new view identifier to rename to","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_RenameTableRequest"},"examples":{"RenameViewSameNamespace":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_RenameViewSameNamespace"}}}},"required":true},"responses":{"204":{"description":"Success, no content"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - NoSuchViewException, view to rename does not exist - NoSuchNamespaceException, The target namespace of the new identifier does not exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ErrorModel"},"examples":{"ViewToRenameDoesNotExist":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchViewError"},"NamespaceToRenameToDoesNotExist":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchNamespaceError"}}}}},"406":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnsupportedOperationResponse"},"409":{"description":"Conflict - The target identifier to rename to already exists as a table or view","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ErrorModel"},"example":{"summary":"The requested view identifier already exists","value":{"error":{"message":"The given view already exists","type":"AlreadyExistsException","code":409}}}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]}}},"components":{"securitySchemes":{"Polaris_Management_Service_OAuth2":{"type":"oauth2","description":"Uses OAuth 2 with client credentials flow","flows":{"implicit":{"authorizationUrl":"{scheme}://{host}/api/v1/oauth/tokens","scopes":{}}}},"Apache_Iceberg_REST_Catalog_API_OAuth2":{"type":"oauth2","description":"This scheme is used for OAuth2 authorization.\n\nFor unauthorized requests, services should return an appropriate 401 or 403 response. Implementations must not return altered success (200) responses when a request is unauthenticated or unauthorized.\nIf a separate authorization server is used, substitute the tokenUrl with the full token path of the external authorization server, and use the resulting token to access the resources defined in the spec.","flows":{"clientCredentials":{"tokenUrl":"/v1/oauth/tokens","scopes":{"catalog":"Allows interacting with the Config and Catalog APIs"}}}},"Apache_Iceberg_REST_Catalog_API_BearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"Polaris_Management_Service_Catalogs":{"type":"object","description":"A list of Catalog objects","properties":{"catalogs":{"type":"array","items":{"$ref":"#/components/schemas/Polaris_Management_Service_Catalog"}}},"required":["catalogs"]},"Polaris_Management_Service_CreateCatalogRequest":{"type":"object","description":"Request to create a new catalog","properties":{"catalog":{"$ref":"#/components/schemas/Polaris_Management_Service_Catalog"}},"required":["catalog"]},"Polaris_Management_Service_Catalog":{"type":"object","description":"A catalog object. A catalog may be internal or external. Internal catalogs are managed entirely by an external catalog interface. Third party catalogs may be other Iceberg REST implementations or other services with their own proprietary APIs","properties":{"type":{"type":"string","enum":["INTERNAL","EXTERNAL"],"description":"the type of catalog - internal or external","default":"INTERNAL"},"name":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$","description":"The name of the catalog"},"properties":{"type":"object","properties":{"default-base-location":{"type":"string"}},"additionalProperties":{"type":"string"},"required":["default-base-location"]},"createTimestamp":{"type":"integer","format":"int64","description":"The creation time represented as unix epoch timestamp in milliseconds"},"lastUpdateTimestamp":{"type":"integer","format":"int64","description":"The last update time represented as unix epoch timestamp in milliseconds"},"entityVersion":{"type":"integer","description":"The version of the catalog object used to determine if the catalog metadata has changed"},"storageConfigInfo":{"$ref":"#/components/schemas/Polaris_Management_Service_StorageConfigInfo"}},"required":["name","type","storageConfigInfo","properties"],"discriminator":{"propertyName":"type","mapping":{"INTERNAL":"#/components/schemas/Polaris_Management_Service_PolarisCatalog","EXTERNAL":"#/components/schemas/Polaris_Management_Service_ExternalCatalog"}}},"Polaris_Management_Service_PolarisCatalog":{"type":"object","allOf":[{"$ref":"#/components/schemas/Polaris_Management_Service_Catalog"}],"description":"The base catalog type - this contains all the fields necessary to construct an INTERNAL catalog"},"Polaris_Management_Service_ExternalCatalog":{"description":"An externally managed catalog","type":"object","allOf":[{"$ref":"#/components/schemas/Polaris_Management_Service_Catalog"},{"type":"object","properties":{"remoteUrl":{"type":"string","description":"URL to the remote catalog API"}}}]},"Polaris_Management_Service_StorageConfigInfo":{"type":"object","description":"A storage configuration used by catalogs","properties":{"storageType":{"type":"string","enum":["S3","GCS","AZURE","FILE"],"description":"The cloud provider type this storage is built on. FILE is supported for testing purposes only"},"allowedLocations":{"type":"array","items":{"type":"string"},"example":"For AWS [s3://bucketname/prefix/], for AZURE [abfss://container@storageaccount.blob.core.windows.net/prefix/], for GCP [gs://bucketname/prefix/]"}},"required":["storageType"],"discriminator":{"propertyName":"storageType","mapping":{"S3":"#/components/schemas/Polaris_Management_Service_AwsStorageConfigInfo","AZURE":"#/components/schemas/Polaris_Management_Service_AzureStorageConfigInfo","GCS":"#/components/schemas/Polaris_Management_Service_GcpStorageConfigInfo","FILE":"#/components/schemas/Polaris_Management_Service_FileStorageConfigInfo"}}},"Polaris_Management_Service_AwsStorageConfigInfo":{"type":"object","description":"aws storage configuration info","allOf":[{"$ref":"#/components/schemas/Polaris_Management_Service_StorageConfigInfo"}],"properties":{"roleArn":{"type":"string","description":"the aws role arn that grants privileges on the S3 buckets","example":"arn:aws:iam::123456789001:principal/abc1-b-self1234"},"externalId":{"type":"string","description":"an optional external id used to establish a trust relationship with AWS in the trust policy"},"userArn":{"type":"string","description":"the aws user arn used to assume the aws role","example":"arn:aws:iam::123456789001:user/abc1-b-self1234"}},"required":["roleArn"]},"Polaris_Management_Service_AzureStorageConfigInfo":{"type":"object","description":"azure storage configuration info","allOf":[{"$ref":"#/components/schemas/Polaris_Management_Service_StorageConfigInfo"}],"properties":{"tenantId":{"type":"string","description":"the tenant id that the storage accounts belong to"},"multiTenantAppName":{"type":"string","description":"the name of the azure client application"},"consentUrl":{"type":"string","description":"URL to the Azure permissions request page"}},"required":["tenantId"]},"Polaris_Management_Service_GcpStorageConfigInfo":{"type":"object","description":"gcp storage configuration info","allOf":[{"$ref":"#/components/schemas/Polaris_Management_Service_StorageConfigInfo"}],"properties":{"gcsServiceAccount":{"type":"string","description":"a Google cloud storage service account"}}},"Polaris_Management_Service_FileStorageConfigInfo":{"type":"object","description":"gcp storage configuration info","allOf":[{"$ref":"#/components/schemas/Polaris_Management_Service_StorageConfigInfo"}]},"Polaris_Management_Service_UpdateCatalogRequest":{"description":"Updates to apply to a Catalog","type":"object","properties":{"currentEntityVersion":{"type":"integer","description":"The version of the object onto which this update is applied; if the object changed, the update will fail and the caller should retry after fetching the latest version."},"properties":{"type":"object","additionalProperties":{"type":"string"}},"storageConfigInfo":{"$ref":"#/components/schemas/Polaris_Management_Service_StorageConfigInfo"}}},"Polaris_Management_Service_Principals":{"description":"A list of Principals","type":"object","properties":{"principals":{"type":"array","items":{"$ref":"#/components/schemas/Polaris_Management_Service_Principal"}}},"required":["principals"]},"Polaris_Management_Service_PrincipalWithCredentials":{"description":"A user with its client id and secret. This type is returned when a new principal is created or when its credentials are rotated","type":"object","properties":{"principal":{"$ref":"#/components/schemas/Polaris_Management_Service_Principal"},"credentials":{"type":"object","properties":{"clientId":{"type":"string"},"clientSecret":{"type":"string","format":"password"}}}},"required":["principal","credentials"]},"Polaris_Management_Service_CreatePrincipalRequest":{"type":"object","properties":{"principal":{"$ref":"#/components/schemas/Polaris_Management_Service_Principal"},"credentialRotationRequired":{"type":"boolean","description":"If true, the initial credentials can only be used to call rotateCredentials"}}},"Polaris_Management_Service_Principal":{"description":"A Polaris principal.","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"},"clientId":{"type":"string","description":"The output-only OAuth clientId associated with this principal if applicable"},"properties":{"type":"object","additionalProperties":{"type":"string"}},"createTimestamp":{"type":"integer","format":"int64"},"lastUpdateTimestamp":{"type":"integer","format":"int64"},"entityVersion":{"type":"integer","description":"The version of the principal object used to determine if the principal metadata has changed"}},"required":["name"]},"Polaris_Management_Service_UpdatePrincipalRequest":{"description":"Updates to apply to a Principal","type":"object","properties":{"currentEntityVersion":{"type":"integer","description":"The version of the object onto which this update is applied; if the object changed, the update will fail and the caller should retry after fetching the latest version."},"properties":{"type":"object","additionalProperties":{"type":"string"}}},"required":["currentEntityVersion","properties"]},"Polaris_Management_Service_PrincipalRoles":{"type":"object","properties":{"roles":{"type":"array","items":{"$ref":"#/components/schemas/Polaris_Management_Service_PrincipalRole"}}},"required":["roles"]},"Polaris_Management_Service_GrantPrincipalRoleRequest":{"type":"object","properties":{"principalRole":{"$ref":"#/components/schemas/Polaris_Management_Service_PrincipalRole"}}},"Polaris_Management_Service_CreatePrincipalRoleRequest":{"type":"object","properties":{"principalRole":{"$ref":"#/components/schemas/Polaris_Management_Service_PrincipalRole"}}},"Polaris_Management_Service_PrincipalRole":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$","description":"The name of the role"},"properties":{"type":"object","additionalProperties":{"type":"string"}},"createTimestamp":{"type":"integer","format":"int64"},"lastUpdateTimestamp":{"type":"integer","format":"int64"},"entityVersion":{"type":"integer","description":"The version of the principal role object used to determine if the principal role metadata has changed"}},"required":["name"]},"Polaris_Management_Service_UpdatePrincipalRoleRequest":{"description":"Updates to apply to a Principal Role","type":"object","properties":{"currentEntityVersion":{"type":"integer","description":"The version of the object onto which this update is applied; if the object changed, the update will fail and the caller should retry after fetching the latest version."},"properties":{"type":"object","additionalProperties":{"type":"string"}}},"required":["currentEntityVersion","properties"]},"Polaris_Management_Service_CatalogRoles":{"type":"object","properties":{"roles":{"type":"array","items":{"$ref":"#/components/schemas/Polaris_Management_Service_CatalogRole"},"description":"The list of catalog roles"}},"required":["roles"]},"Polaris_Management_Service_GrantCatalogRoleRequest":{"type":"object","properties":{"catalogRole":{"$ref":"#/components/schemas/Polaris_Management_Service_CatalogRole"}}},"Polaris_Management_Service_CreateCatalogRoleRequest":{"type":"object","properties":{"catalogRole":{"$ref":"#/components/schemas/Polaris_Management_Service_CatalogRole"}}},"Polaris_Management_Service_CatalogRole":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$","description":"The name of the role"},"properties":{"type":"object","additionalProperties":{"type":"string"}},"createTimestamp":{"type":"integer","format":"int64"},"lastUpdateTimestamp":{"type":"integer","format":"int64"},"entityVersion":{"type":"integer","description":"The version of the catalog role object used to determine if the catalog role metadata has changed"}},"required":["name"]},"Polaris_Management_Service_UpdateCatalogRoleRequest":{"description":"Updates to apply to a Catalog Role","type":"object","properties":{"currentEntityVersion":{"type":"integer","description":"The version of the object onto which this update is applied; if the object changed, the update will fail and the caller should retry after fetching the latest version."},"properties":{"type":"object","additionalProperties":{"type":"string"}}},"required":["currentEntityVersion","properties"]},"Polaris_Management_Service_ViewPrivilege":{"type":"string","enum":["CATALOG_MANAGE_ACCESS","VIEW_CREATE","VIEW_DROP","VIEW_LIST","VIEW_READ_PROPERTIES","VIEW_WRITE_PROPERTIES","VIEW_FULL_METADATA"]},"Polaris_Management_Service_TablePrivilege":{"type":"string","enum":["CATALOG_MANAGE_ACCESS","TABLE_DROP","TABLE_LIST","TABLE_READ_PROPERTIES","VIEW_READ_PROPERTIES","TABLE_WRITE_PROPERTIES","TABLE_READ_DATA","TABLE_WRITE_DATA","TABLE_FULL_METADATA"]},"Polaris_Management_Service_NamespacePrivilege":{"type":"string","enum":["CATALOG_MANAGE_ACCESS","CATALOG_MANAGE_CONTENT","CATALOG_MANAGE_METADATA","NAMESPACE_CREATE","TABLE_CREATE","VIEW_CREATE","NAMESPACE_DROP","TABLE_DROP","VIEW_DROP","NAMESPACE_LIST","TABLE_LIST","VIEW_LIST","NAMESPACE_READ_PROPERTIES","TABLE_READ_PROPERTIES","VIEW_READ_PROPERTIES","NAMESPACE_WRITE_PROPERTIES","TABLE_WRITE_PROPERTIES","VIEW_WRITE_PROPERTIES","TABLE_READ_DATA","TABLE_WRITE_DATA","NAMESPACE_FULL_METADATA","TABLE_FULL_METADATA","VIEW_FULL_METADATA"]},"Polaris_Management_Service_CatalogPrivilege":{"type":"string","enum":["CATALOG_MANAGE_ACCESS","CATALOG_MANAGE_CONTENT","CATALOG_MANAGE_METADATA","CATALOG_READ_PROPERTIES","CATALOG_WRITE_PROPERTIES","NAMESPACE_CREATE","TABLE_CREATE","VIEW_CREATE","NAMESPACE_DROP","TABLE_DROP","VIEW_DROP","NAMESPACE_LIST","TABLE_LIST","VIEW_LIST","NAMESPACE_READ_PROPERTIES","TABLE_READ_PROPERTIES","VIEW_READ_PROPERTIES","NAMESPACE_WRITE_PROPERTIES","TABLE_WRITE_PROPERTIES","VIEW_WRITE_PROPERTIES","TABLE_READ_DATA","TABLE_WRITE_DATA","NAMESPACE_FULL_METADATA","TABLE_FULL_METADATA","VIEW_FULL_METADATA"]},"Polaris_Management_Service_AddGrantRequest":{"type":"object","properties":{"grant":{"$ref":"#/components/schemas/Polaris_Management_Service_GrantResource"}}},"Polaris_Management_Service_RevokeGrantRequest":{"type":"object","properties":{"grant":{"$ref":"#/components/schemas/Polaris_Management_Service_GrantResource"}}},"Polaris_Management_Service_ViewGrant":{"allOf":[{"$ref":"#/components/schemas/Polaris_Management_Service_GrantResource"},{"type":"object","properties":{"namespace":{"type":"array","items":{"type":"string"}},"viewName":{"type":"string","minLength":1,"maxLength":256},"privilege":{"$ref":"#/components/schemas/Polaris_Management_Service_ViewPrivilege"}},"required":["namespace","viewName","privilege"]}]},"Polaris_Management_Service_TableGrant":{"allOf":[{"$ref":"#/components/schemas/Polaris_Management_Service_GrantResource"},{"type":"object","properties":{"namespace":{"type":"array","items":{"type":"string"}},"tableName":{"type":"string","minLength":1,"maxLength":256},"privilege":{"$ref":"#/components/schemas/Polaris_Management_Service_TablePrivilege"}},"required":["namespace","tableName","privilege"]}]},"Polaris_Management_Service_NamespaceGrant":{"allOf":[{"$ref":"#/components/schemas/Polaris_Management_Service_GrantResource"},{"type":"object","properties":{"namespace":{"type":"array","items":{"type":"string"}},"privilege":{"$ref":"#/components/schemas/Polaris_Management_Service_NamespacePrivilege"}},"required":["namespace","privilege"]}]},"Polaris_Management_Service_CatalogGrant":{"allOf":[{"$ref":"#/components/schemas/Polaris_Management_Service_GrantResource"},{"type":"object","properties":{"privilege":{"$ref":"#/components/schemas/Polaris_Management_Service_CatalogPrivilege"}},"required":["privilege"]}]},"Polaris_Management_Service_GrantResource":{"type":"object","discriminator":{"propertyName":"type","mapping":{"catalog":"#/components/schemas/Polaris_Management_Service_CatalogGrant","namespace":"#/components/schemas/Polaris_Management_Service_NamespaceGrant","table":"#/components/schemas/Polaris_Management_Service_TableGrant","view":"#/components/schemas/Polaris_Management_Service_ViewGrant"}},"properties":{"type":{"type":"string","enum":["catalog","namespace","table","view"]}},"required":["type"]},"Polaris_Management_Service_GrantResources":{"type":"object","properties":{"grants":{"type":"array","items":{"$ref":"#/components/schemas/Polaris_Management_Service_GrantResource"}}},"required":["grants"]},"Apache_Iceberg_REST_Catalog_API_ErrorModel":{"type":"object","description":"JSON error payload returned in a response with further details on the error","required":["message","type","code"],"properties":{"message":{"type":"string","description":"Human-readable error message"},"type":{"type":"string","description":"Internal type definition of the error","example":"NoSuchNamespaceException"},"code":{"type":"integer","minimum":400,"maximum":600,"description":"HTTP response code","example":404},"stack":{"type":"array","items":{"type":"string"}}}},"Apache_Iceberg_REST_Catalog_API_CatalogConfig":{"type":"object","description":"Server-provided configuration for the catalog.","required":["defaults","overrides"],"properties":{"overrides":{"type":"object","additionalProperties":{"type":"string"},"description":"Properties that should be used to override client configuration; applied after defaults and client configuration."},"defaults":{"type":"object","additionalProperties":{"type":"string"},"description":"Properties that should be used as default configuration; applied before client configuration."}}},"Apache_Iceberg_REST_Catalog_API_CreateNamespaceRequest":{"type":"object","required":["namespace"],"properties":{"namespace":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Namespace"},"properties":{"type":"object","description":"Configured string to string map of properties for the namespace","example":{"owner":"Hank Bendickson"},"default":{},"additionalProperties":{"type":"string"}}}},"Apache_Iceberg_REST_Catalog_API_UpdateNamespacePropertiesRequest":{"type":"object","properties":{"removals":{"type":"array","uniqueItems":true,"items":{"type":"string"},"example":["department","access_group"]},"updates":{"type":"object","example":{"owner":"Hank Bendickson"},"additionalProperties":{"type":"string"}}}},"Apache_Iceberg_REST_Catalog_API_RenameTableRequest":{"type":"object","required":["source","destination"],"properties":{"source":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TableIdentifier"},"destination":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TableIdentifier"}}},"Apache_Iceberg_REST_Catalog_API_Namespace":{"description":"Reference to one or more levels of a namespace","type":"array","items":{"type":"string"},"example":["accounting","tax"]},"Apache_Iceberg_REST_Catalog_API_PageToken":{"description":"An opaque token that allows clients to make use of pagination for list APIs (e.g. ListTables). Clients may initiate the first paginated request by sending an empty query parameter `pageToken` to the server.\nServers that support pagination should identify the `pageToken` parameter and return a `next-page-token` in the response if there are more results available.  After the initial request, the value of `next-page-token` from each response must be used as the `pageToken` parameter value for the next request. The server must return `null` value for the `next-page-token` in the last response.\nServers that support pagination must return all results in a single response with the value of `next-page-token` set to `null` if the query parameter `pageToken` is not set in the request.\nServers that do not support pagination should ignore the `pageToken` parameter and return all results in a single response. The `next-page-token` must be omitted from the response.\nClients must interpret either `null` or missing response value of `next-page-token` as the end of the listing results.","type":"string","nullable":true},"Apache_Iceberg_REST_Catalog_API_TableIdentifier":{"type":"object","required":["namespace","name"],"properties":{"namespace":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Namespace"},"name":{"type":"string","nullable":false}}},"Apache_Iceberg_REST_Catalog_API_PrimitiveType":{"type":"string","example":["long","string","fixed[16]","decimal(10,2)"]},"Apache_Iceberg_REST_Catalog_API_StructField":{"type":"object","required":["id","name","type","required"],"properties":{"id":{"type":"integer"},"name":{"type":"string"},"type":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Type"},"required":{"type":"boolean"},"doc":{"type":"string"}}},"Apache_Iceberg_REST_Catalog_API_StructType":{"type":"object","required":["type","fields"],"properties":{"type":{"type":"string","enum":["struct"]},"fields":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_StructField"}}}},"Apache_Iceberg_REST_Catalog_API_ListType":{"type":"object","required":["type","element-id","element","element-required"],"properties":{"type":{"type":"string","enum":["list"]},"element-id":{"type":"integer"},"element":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Type"},"element-required":{"type":"boolean"}}},"Apache_Iceberg_REST_Catalog_API_MapType":{"type":"object","required":["type","key-id","key","value-id","value","value-required"],"properties":{"type":{"type":"string","enum":["map"]},"key-id":{"type":"integer"},"key":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Type"},"value-id":{"type":"integer"},"value":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Type"},"value-required":{"type":"boolean"}}},"Apache_Iceberg_REST_Catalog_API_Type":{"oneOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_PrimitiveType"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_StructType"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ListType"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_MapType"}]},"Apache_Iceberg_REST_Catalog_API_Schema":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_StructType"},{"type":"object","properties":{"schema-id":{"type":"integer","readOnly":true},"identifier-field-ids":{"type":"array","items":{"type":"integer"}}}}]},"Apache_Iceberg_REST_Catalog_API_Expression":{"oneOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AndOrExpression"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_NotExpression"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SetExpression"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_LiteralExpression"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_UnaryExpression"}]},"Apache_Iceberg_REST_Catalog_API_ExpressionType":{"type":"string","example":["eq","and","or","not","in","not-in","lt","lt-eq","gt","gt-eq","not-eq","starts-with","not-starts-with","is-null","not-null","is-nan","not-nan"]},"Apache_Iceberg_REST_Catalog_API_AndOrExpression":{"type":"object","required":["type","left","right"],"properties":{"type":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ExpressionType","enum":["and","or"]},"left":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Expression"},"right":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Expression"}}},"Apache_Iceberg_REST_Catalog_API_NotExpression":{"type":"object","required":["type","child"],"properties":{"type":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ExpressionType","enum":["not"]},"child":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Expression"}}},"Apache_Iceberg_REST_Catalog_API_UnaryExpression":{"type":"object","required":["type","term","value"],"properties":{"type":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ExpressionType","enum":["is-null","not-null","is-nan","not-nan"]},"term":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Term"},"value":{"type":"object"}}},"Apache_Iceberg_REST_Catalog_API_LiteralExpression":{"type":"object","required":["type","term","value"],"properties":{"type":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ExpressionType","enum":["lt","lt-eq","gt","gt-eq","eq","not-eq","starts-with","not-starts-with"]},"term":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Term"},"value":{"type":"object"}}},"Apache_Iceberg_REST_Catalog_API_SetExpression":{"type":"object","required":["type","term","values"],"properties":{"type":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ExpressionType","enum":["in","not-in"]},"term":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Term"},"values":{"type":"array","items":{"type":"object"}}}},"Apache_Iceberg_REST_Catalog_API_Term":{"oneOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Reference"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TransformTerm"}]},"Apache_Iceberg_REST_Catalog_API_Reference":{"type":"string","example":["column-name"]},"Apache_Iceberg_REST_Catalog_API_TransformTerm":{"type":"object","required":["type","transform","term"],"properties":{"type":{"type":"string","enum":["transform"]},"transform":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Transform"},"term":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Reference"}}},"Apache_Iceberg_REST_Catalog_API_Transform":{"type":"string","example":["identity","year","month","day","hour","bucket[256]","truncate[16]"]},"Apache_Iceberg_REST_Catalog_API_PartitionField":{"type":"object","required":["source-id","transform","name"],"properties":{"field-id":{"type":"integer"},"source-id":{"type":"integer"},"name":{"type":"string"},"transform":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Transform"}}},"Apache_Iceberg_REST_Catalog_API_PartitionSpec":{"type":"object","required":["fields"],"properties":{"spec-id":{"type":"integer","readOnly":true},"fields":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_PartitionField"}}}},"Apache_Iceberg_REST_Catalog_API_SortDirection":{"type":"string","enum":["asc","desc"]},"Apache_Iceberg_REST_Catalog_API_NullOrder":{"type":"string","enum":["nulls-first","nulls-last"]},"Apache_Iceberg_REST_Catalog_API_SortField":{"type":"object","required":["source-id","transform","direction","null-order"],"properties":{"source-id":{"type":"integer"},"transform":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Transform"},"direction":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SortDirection"},"null-order":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_NullOrder"}}},"Apache_Iceberg_REST_Catalog_API_SortOrder":{"type":"object","required":["order-id","fields"],"properties":{"order-id":{"type":"integer","readOnly":true},"fields":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SortField"}}}},"Apache_Iceberg_REST_Catalog_API_Snapshot":{"type":"object","required":["snapshot-id","timestamp-ms","manifest-list","summary"],"properties":{"snapshot-id":{"type":"integer","format":"int64"},"parent-snapshot-id":{"type":"integer","format":"int64"},"sequence-number":{"type":"integer","format":"int64"},"timestamp-ms":{"type":"integer","format":"int64"},"manifest-list":{"type":"string","description":"Location of the snapshot's manifest list file"},"summary":{"type":"object","required":["operation"],"properties":{"operation":{"type":"string","enum":["append","replace","overwrite","delete"]}},"additionalProperties":{"type":"string"}},"schema-id":{"type":"integer"}}},"Apache_Iceberg_REST_Catalog_API_SnapshotReference":{"type":"object","required":["type","snapshot-id"],"properties":{"type":{"type":"string","enum":["tag","branch"]},"snapshot-id":{"type":"integer","format":"int64"},"max-ref-age-ms":{"type":"integer","format":"int64"},"max-snapshot-age-ms":{"type":"integer","format":"int64"},"min-snapshots-to-keep":{"type":"integer"}}},"Apache_Iceberg_REST_Catalog_API_SnapshotReferences":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SnapshotReference"}},"Apache_Iceberg_REST_Catalog_API_SnapshotLog":{"type":"array","items":{"type":"object","required":["snapshot-id","timestamp-ms"],"properties":{"snapshot-id":{"type":"integer","format":"int64"},"timestamp-ms":{"type":"integer","format":"int64"}}}},"Apache_Iceberg_REST_Catalog_API_MetadataLog":{"type":"array","items":{"type":"object","required":["metadata-file","timestamp-ms"],"properties":{"metadata-file":{"type":"string"},"timestamp-ms":{"type":"integer","format":"int64"}}}},"Apache_Iceberg_REST_Catalog_API_TableMetadata":{"type":"object","required":["format-version","table-uuid"],"properties":{"format-version":{"type":"integer","minimum":1,"maximum":2},"table-uuid":{"type":"string"},"location":{"type":"string"},"last-updated-ms":{"type":"integer","format":"int64"},"properties":{"type":"object","additionalProperties":{"type":"string"}},"schemas":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Schema"}},"current-schema-id":{"type":"integer"},"last-column-id":{"type":"integer"},"partition-specs":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_PartitionSpec"}},"default-spec-id":{"type":"integer"},"last-partition-id":{"type":"integer"},"sort-orders":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SortOrder"}},"default-sort-order-id":{"type":"integer"},"snapshots":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Snapshot"}},"refs":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SnapshotReferences"},"current-snapshot-id":{"type":"integer","format":"int64"},"last-sequence-number":{"type":"integer","format":"int64"},"snapshot-log":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SnapshotLog"},"metadata-log":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_MetadataLog"},"statistics-files":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_StatisticsFile"}},"partition-statistics-files":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_PartitionStatisticsFile"}}}},"Apache_Iceberg_REST_Catalog_API_SQLViewRepresentation":{"type":"object","required":["type","sql","dialect"],"properties":{"type":{"type":"string"},"sql":{"type":"string"},"dialect":{"type":"string"}}},"Apache_Iceberg_REST_Catalog_API_ViewRepresentation":{"oneOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SQLViewRepresentation"}]},"Apache_Iceberg_REST_Catalog_API_ViewHistoryEntry":{"type":"object","required":["version-id","timestamp-ms"],"properties":{"version-id":{"type":"integer"},"timestamp-ms":{"type":"integer","format":"int64"}}},"Apache_Iceberg_REST_Catalog_API_ViewVersion":{"type":"object","required":["version-id","timestamp-ms","schema-id","summary","representations","default-namespace"],"properties":{"version-id":{"type":"integer"},"timestamp-ms":{"type":"integer","format":"int64"},"schema-id":{"type":"integer","description":"Schema ID to set as current, or -1 to set last added schema"},"summary":{"type":"object","additionalProperties":{"type":"string"}},"representations":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ViewRepresentation"}},"default-catalog":{"type":"string"},"default-namespace":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Namespace"}}},"Apache_Iceberg_REST_Catalog_API_ViewMetadata":{"type":"object","required":["view-uuid","format-version","location","current-version-id","versions","version-log","schemas"],"properties":{"view-uuid":{"type":"string"},"format-version":{"type":"integer","minimum":1,"maximum":1},"location":{"type":"string"},"current-version-id":{"type":"integer"},"versions":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ViewVersion"}},"version-log":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ViewHistoryEntry"}},"schemas":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Schema"}},"properties":{"type":"object","additionalProperties":{"type":"string"}}}},"Apache_Iceberg_REST_Catalog_API_BaseUpdate":{"discriminator":{"propertyName":"action","mapping":{"assign-uuid":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AssignUUIDUpdate","upgrade-format-version":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_UpgradeFormatVersionUpdate","add-schema":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AddSchemaUpdate","set-current-schema":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SetCurrentSchemaUpdate","add-spec":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AddPartitionSpecUpdate","set-default-spec":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SetDefaultSpecUpdate","add-sort-order":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AddSortOrderUpdate","set-default-sort-order":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SetDefaultSortOrderUpdate","add-snapshot":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AddSnapshotUpdate","set-snapshot-ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SetSnapshotRefUpdate","remove-snapshots":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_RemoveSnapshotsUpdate","remove-snapshot-ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_RemoveSnapshotRefUpdate","set-location":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SetLocationUpdate","set-properties":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SetPropertiesUpdate","remove-properties":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_RemovePropertiesUpdate","add-view-version":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AddViewVersionUpdate","set-current-view-version":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SetCurrentViewVersionUpdate","set-statistics":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SetStatisticsUpdate","remove-statistics":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_RemoveStatisticsUpdate","set-partition-statistics":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SetPartitionStatisticsUpdate","remove-partition-statistics":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_RemovePartitionStatisticsUpdate"}},"type":"object","required":["action"],"properties":{"action":{"type":"string"}}},"Apache_Iceberg_REST_Catalog_API_AssignUUIDUpdate":{"description":"Assigning a UUID to a table/view should only be done when creating the table/view. It is not safe to re-assign the UUID if a table/view already has a UUID assigned","allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"}],"required":["action","uuid"],"properties":{"action":{"type":"string","enum":["assign-uuid"]},"uuid":{"type":"string"}}},"Apache_Iceberg_REST_Catalog_API_UpgradeFormatVersionUpdate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"}],"required":["action","format-version"],"properties":{"action":{"type":"string","enum":["upgrade-format-version"]},"format-version":{"type":"integer"}}},"Apache_Iceberg_REST_Catalog_API_AddSchemaUpdate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"}],"required":["action","schema"],"properties":{"action":{"type":"string","enum":["add-schema"]},"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Schema"},"last-column-id":{"type":"integer","description":"The highest assigned column ID for the table. This is used to ensure columns are always assigned an unused ID when evolving schemas. When omitted, it will be computed on the server side."}}},"Apache_Iceberg_REST_Catalog_API_SetCurrentSchemaUpdate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"}],"required":["action","schema-id"],"properties":{"action":{"type":"string","enum":["set-current-schema"]},"schema-id":{"type":"integer","description":"Schema ID to set as current, or -1 to set last added schema"}}},"Apache_Iceberg_REST_Catalog_API_AddPartitionSpecUpdate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"}],"required":["action","spec"],"properties":{"action":{"type":"string","enum":["add-spec"]},"spec":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_PartitionSpec"}}},"Apache_Iceberg_REST_Catalog_API_SetDefaultSpecUpdate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"}],"required":["action","spec-id"],"properties":{"action":{"type":"string","enum":["set-default-spec"]},"spec-id":{"type":"integer","description":"Partition spec ID to set as the default, or -1 to set last added spec"}}},"Apache_Iceberg_REST_Catalog_API_AddSortOrderUpdate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"}],"required":["action","sort-order"],"properties":{"action":{"type":"string","enum":["add-sort-order"]},"sort-order":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SortOrder"}}},"Apache_Iceberg_REST_Catalog_API_SetDefaultSortOrderUpdate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"}],"required":["action","sort-order-id"],"properties":{"action":{"type":"string","enum":["set-default-sort-order"]},"sort-order-id":{"type":"integer","description":"Sort order ID to set as the default, or -1 to set last added sort order"}}},"Apache_Iceberg_REST_Catalog_API_AddSnapshotUpdate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"}],"required":["action","snapshot"],"properties":{"action":{"type":"string","enum":["add-snapshot"]},"snapshot":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Snapshot"}}},"Apache_Iceberg_REST_Catalog_API_SetSnapshotRefUpdate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SnapshotReference"}],"required":["action","ref-name"],"properties":{"action":{"type":"string","enum":["set-snapshot-ref"]},"ref-name":{"type":"string"}}},"Apache_Iceberg_REST_Catalog_API_RemoveSnapshotsUpdate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"}],"required":["action","snapshot-ids"],"properties":{"action":{"type":"string","enum":["remove-snapshots"]},"snapshot-ids":{"type":"array","items":{"type":"integer","format":"int64"}}}},"Apache_Iceberg_REST_Catalog_API_RemoveSnapshotRefUpdate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"}],"required":["action","ref-name"],"properties":{"action":{"type":"string","enum":["remove-snapshot-ref"]},"ref-name":{"type":"string"}}},"Apache_Iceberg_REST_Catalog_API_SetLocationUpdate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"}],"required":["action","location"],"properties":{"action":{"type":"string","enum":["set-location"]},"location":{"type":"string"}}},"Apache_Iceberg_REST_Catalog_API_SetPropertiesUpdate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"}],"required":["action","updates"],"properties":{"action":{"type":"string","enum":["set-properties"]},"updates":{"type":"object","additionalProperties":{"type":"string"}}}},"Apache_Iceberg_REST_Catalog_API_RemovePropertiesUpdate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"}],"required":["action","removals"],"properties":{"action":{"type":"string","enum":["remove-properties"]},"removals":{"type":"array","items":{"type":"string"}}}},"Apache_Iceberg_REST_Catalog_API_AddViewVersionUpdate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"}],"required":["action","view-version"],"properties":{"action":{"type":"string","enum":["add-view-version"]},"view-version":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ViewVersion"}}},"Apache_Iceberg_REST_Catalog_API_SetCurrentViewVersionUpdate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"}],"required":["action","view-version-id"],"properties":{"action":{"type":"string","enum":["set-current-view-version"]},"view-version-id":{"type":"integer","description":"The view version id to set as current, or -1 to set last added view version id"}}},"Apache_Iceberg_REST_Catalog_API_SetStatisticsUpdate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"}],"required":["action","snapshot-id","statistics"],"properties":{"action":{"type":"string","enum":["set-statistics"]},"snapshot-id":{"type":"integer","format":"int64"},"statistics":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_StatisticsFile"}}},"Apache_Iceberg_REST_Catalog_API_RemoveStatisticsUpdate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"}],"required":["action","snapshot-id"],"properties":{"action":{"type":"string","enum":["remove-statistics"]},"snapshot-id":{"type":"integer","format":"int64"}}},"Apache_Iceberg_REST_Catalog_API_SetPartitionStatisticsUpdate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"}],"required":["action","partition-statistics"],"properties":{"action":{"type":"string","enum":["set-partition-statistics"]},"partition-statistics":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_PartitionStatisticsFile"}}},"Apache_Iceberg_REST_Catalog_API_RemovePartitionStatisticsUpdate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"}],"required":["action","snapshot-id"],"properties":{"action":{"type":"string","enum":["remove-partition-statistics"]},"snapshot-id":{"type":"integer","format":"int64"}}},"Apache_Iceberg_REST_Catalog_API_TableUpdate":{"anyOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AssignUUIDUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_UpgradeFormatVersionUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AddSchemaUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SetCurrentSchemaUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AddPartitionSpecUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SetDefaultSpecUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AddSortOrderUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SetDefaultSortOrderUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AddSnapshotUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SetSnapshotRefUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_RemoveSnapshotsUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_RemoveSnapshotRefUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SetLocationUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SetPropertiesUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_RemovePropertiesUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SetStatisticsUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_RemoveStatisticsUpdate"}]},"Apache_Iceberg_REST_Catalog_API_ViewUpdate":{"anyOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AssignUUIDUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_UpgradeFormatVersionUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AddSchemaUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SetLocationUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SetPropertiesUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_RemovePropertiesUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AddViewVersionUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SetCurrentViewVersionUpdate"}]},"Apache_Iceberg_REST_Catalog_API_TableRequirement":{"discriminator":{"propertyName":"type","mapping":{"assert-create":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AssertCreate","assert-table-uuid":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AssertTableUUID","assert-ref-snapshot-id":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AssertRefSnapshotId","assert-last-assigned-field-id":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AssertLastAssignedFieldId","assert-current-schema-id":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AssertCurrentSchemaId","assert-last-assigned-partition-id":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AssertLastAssignedPartitionId","assert-default-spec-id":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AssertDefaultSpecId","assert-default-sort-order-id":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AssertDefaultSortOrderId"}},"type":"object","required":["type"],"properties":{"type":{"type":"string"}}},"Apache_Iceberg_REST_Catalog_API_AssertCreate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TableRequirement"}],"type":"object","description":"The table must not already exist; used for create transactions","required":["type"],"properties":{"type":{"type":"string","enum":["assert-create"]}}},"Apache_Iceberg_REST_Catalog_API_AssertTableUUID":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TableRequirement"}],"description":"The table UUID must match the requirement's `uuid`","required":["type","uuid"],"properties":{"type":{"type":"string","enum":["assert-table-uuid"]},"uuid":{"type":"string"}}},"Apache_Iceberg_REST_Catalog_API_AssertRefSnapshotId":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TableRequirement"}],"description":"The table branch or tag identified by the requirement's `ref` must reference the requirement's `snapshot-id`; if `snapshot-id` is `null` or missing, the ref must not already exist","required":["type","ref","snapshot-id"],"properties":{"type":{"type":"string","enum":["assert-ref-snapshot-id"]},"ref":{"type":"string"},"snapshot-id":{"type":"integer","format":"int64"}}},"Apache_Iceberg_REST_Catalog_API_AssertLastAssignedFieldId":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TableRequirement"}],"description":"The table's last assigned column id must match the requirement's `last-assigned-field-id`","required":["type","last-assigned-field-id"],"properties":{"type":{"type":"string","enum":["assert-last-assigned-field-id"]},"last-assigned-field-id":{"type":"integer"}}},"Apache_Iceberg_REST_Catalog_API_AssertCurrentSchemaId":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TableRequirement"}],"description":"The table's current schema id must match the requirement's `current-schema-id`","required":["type","current-schema-id"],"properties":{"type":{"type":"string","enum":["assert-current-schema-id"]},"current-schema-id":{"type":"integer"}}},"Apache_Iceberg_REST_Catalog_API_AssertLastAssignedPartitionId":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TableRequirement"}],"description":"The table's last assigned partition id must match the requirement's `last-assigned-partition-id`","required":["type","last-assigned-partition-id"],"properties":{"type":{"type":"string","enum":["assert-last-assigned-partition-id"]},"last-assigned-partition-id":{"type":"integer"}}},"Apache_Iceberg_REST_Catalog_API_AssertDefaultSpecId":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TableRequirement"}],"description":"The table's default spec id must match the requirement's `default-spec-id`","required":["type","default-spec-id"],"properties":{"type":{"type":"string","enum":["assert-default-spec-id"]},"default-spec-id":{"type":"integer"}}},"Apache_Iceberg_REST_Catalog_API_AssertDefaultSortOrderId":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TableRequirement"}],"description":"The table's default sort order id must match the requirement's `default-sort-order-id`","required":["type","default-sort-order-id"],"properties":{"type":{"type":"string","enum":["assert-default-sort-order-id"]},"default-sort-order-id":{"type":"integer"}}},"Apache_Iceberg_REST_Catalog_API_ViewRequirement":{"discriminator":{"propertyName":"type","mapping":{"assert-view-uuid":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AssertViewUUID"}},"type":"object","required":["type"],"properties":{"type":{"type":"string"}}},"Apache_Iceberg_REST_Catalog_API_AssertViewUUID":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ViewRequirement"}],"description":"The view UUID must match the requirement's `uuid`","required":["type","uuid"],"properties":{"type":{"type":"string","enum":["assert-view-uuid"]},"uuid":{"type":"string"}}},"Apache_Iceberg_REST_Catalog_API_LoadTableResult":{"description":"Result used when a table is successfully loaded.\n\n\nThe table metadata JSON is returned in the `metadata` field. The corresponding file location of table metadata should be returned in the `metadata-location` field, unless the metadata is not yet committed. For example, a create transaction may return metadata that is staged but not committed.\nClients can check whether metadata has changed by comparing metadata locations after the table has been created.\n\n\nThe `config` map returns table-specific configuration for the table's resources, including its HTTP client and FileIO. For example, config may contain a specific FileIO implementation class for the table depending on its underlying storage.\n\n\nThe following configurations should be respected by clients:\n\n## General Configurations\n\n- `token`: Authorization bearer token to use for table requests if OAuth2 security is enabled \n\n## AWS Configurations\n\nThe following configurations should be respected when working with tables stored in AWS S3\n - `client.region`: region to configure client for making requests to AWS\n - `s3.access-key-id`: id for for credentials that provide access to the data in S3\n - `s3.secret-access-key`: secret for credentials that provide access to data in S3 \n - `s3.session-token`: if present, this value should be used for as the session token \n - `s3.remote-signing-enabled`: if `true` remote signing should be performed as described in the `s3-signer-open-api.yaml` specification\n","type":"object","required":["metadata"],"properties":{"metadata-location":{"type":"string","description":"May be null if the table is staged as part of a transaction"},"metadata":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TableMetadata"},"config":{"type":"object","additionalProperties":{"type":"string"}}}},"Apache_Iceberg_REST_Catalog_API_CommitTableRequest":{"type":"object","required":["requirements","updates"],"properties":{"identifier":{"description":"Table identifier to update; must be present for CommitTransactionRequest","$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TableIdentifier"},"requirements":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TableRequirement"}},"updates":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TableUpdate"}}}},"Apache_Iceberg_REST_Catalog_API_CommitViewRequest":{"type":"object","required":["updates"],"properties":{"identifier":{"description":"View identifier to update","$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TableIdentifier"},"requirements":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ViewRequirement"}},"updates":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ViewUpdate"}}}},"Apache_Iceberg_REST_Catalog_API_CommitTransactionRequest":{"type":"object","required":["table-changes"],"properties":{"table-changes":{"type":"array","items":{"description":"Table commit request; must provide an `identifier`","$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_CommitTableRequest"}}}},"Apache_Iceberg_REST_Catalog_API_CreateTableRequest":{"type":"object","required":["name","schema"],"properties":{"name":{"type":"string"},"location":{"type":"string"},"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Schema"},"partition-spec":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_PartitionSpec"},"write-order":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SortOrder"},"stage-create":{"type":"boolean"},"properties":{"type":"object","additionalProperties":{"type":"string"}}}},"Apache_Iceberg_REST_Catalog_API_RegisterTableRequest":{"type":"object","required":["name","metadata-location"],"properties":{"name":{"type":"string"},"metadata-location":{"type":"string"}}},"Apache_Iceberg_REST_Catalog_API_CreateViewRequest":{"type":"object","required":["name","schema","view-version","properties"],"properties":{"name":{"type":"string"},"location":{"type":"string"},"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Schema"},"view-version":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ViewVersion","description":"The view version to create, will replace the schema-id sent within the view-version with the id assigned to the provided schema"},"properties":{"type":"object","additionalProperties":{"type":"string"}}}},"Apache_Iceberg_REST_Catalog_API_LoadViewResult":{"description":"Result used when a view is successfully loaded.\n\n\nThe view metadata JSON is returned in the `metadata` field. The corresponding file location of view metadata is returned in the `metadata-location` field.\nClients can check whether metadata has changed by comparing metadata locations after the view has been created.\n\nThe `config` map returns view-specific configuration for the view's resources.\n\nThe following configurations should be respected by clients:\n\n## General Configurations\n\n- `token`: Authorization bearer token to use for view requests if OAuth2 security is enabled\n","type":"object","required":["metadata-location","metadata"],"properties":{"metadata-location":{"type":"string"},"metadata":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ViewMetadata"},"config":{"type":"object","additionalProperties":{"type":"string"}}}},"Apache_Iceberg_REST_Catalog_API_TokenType":{"type":"string","enum":["urn:ietf:params:oauth:token-type:access_token","urn:ietf:params:oauth:token-type:refresh_token","urn:ietf:params:oauth:token-type:id_token","urn:ietf:params:oauth:token-type:saml1","urn:ietf:params:oauth:token-type:saml2","urn:ietf:params:oauth:token-type:jwt"],"description":"Token type identifier, from RFC 8693 Section 3\n\nSee https://datatracker.ietf.org/doc/html/rfc8693#section-3"},"Apache_Iceberg_REST_Catalog_API_OAuthClientCredentialsRequest":{"description":"OAuth2 client credentials request\n\nSee https://datatracker.ietf.org/doc/html/rfc6749#section-4.4","type":"object","required":["grant_type","client_id","client_secret"],"properties":{"grant_type":{"type":"string","enum":["client_credentials"]},"scope":{"type":"string"},"client_id":{"type":"string","description":"Client ID\n\nThis can be sent in the request body, but OAuth2 recommends sending it in a Basic Authorization header."},"client_secret":{"type":"string","description":"Client secret\n\nThis can be sent in the request body, but OAuth2 recommends sending it in a Basic Authorization header."}}},"Apache_Iceberg_REST_Catalog_API_OAuthTokenExchangeRequest":{"description":"OAuth2 token exchange request\n\nSee https://datatracker.ietf.org/doc/html/rfc8693","type":"object","required":["grant_type","subject_token","subject_token_type"],"properties":{"grant_type":{"type":"string","enum":["urn:ietf:params:oauth:grant-type:token-exchange"]},"scope":{"type":"string"},"requested_token_type":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TokenType"},"subject_token":{"type":"string","description":"Subject token for token exchange request"},"subject_token_type":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TokenType"},"actor_token":{"type":"string","description":"Actor token for token exchange request"},"actor_token_type":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TokenType"}}},"Apache_Iceberg_REST_Catalog_API_OAuthTokenRequest":{"anyOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_OAuthClientCredentialsRequest"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_OAuthTokenExchangeRequest"}]},"Apache_Iceberg_REST_Catalog_API_CounterResult":{"type":"object","required":["unit","value"],"properties":{"unit":{"type":"string"},"value":{"type":"integer","format":"int64"}}},"Apache_Iceberg_REST_Catalog_API_TimerResult":{"type":"object","required":["time-unit","count","total-duration"],"properties":{"time-unit":{"type":"string"},"count":{"type":"integer","format":"int64"},"total-duration":{"type":"integer","format":"int64"}}},"Apache_Iceberg_REST_Catalog_API_MetricResult":{"anyOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_CounterResult"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TimerResult"}]},"Apache_Iceberg_REST_Catalog_API_Metrics":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_MetricResult"},"example":{"metrics":{"total-planning-duration":{"count":1,"time-unit":"nanoseconds","total-duration":2644235116},"result-data-files":{"unit":"count","value":1},"result-delete-files":{"unit":"count","value":0},"total-data-manifests":{"unit":"count","value":1},"total-delete-manifests":{"unit":"count","value":0},"scanned-data-manifests":{"unit":"count","value":1},"skipped-data-manifests":{"unit":"count","value":0},"total-file-size-bytes":{"unit":"bytes","value":10},"total-delete-file-size-bytes":{"unit":"bytes","value":0}}}},"Apache_Iceberg_REST_Catalog_API_ReportMetricsRequest":{"anyOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ScanReport"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_CommitReport"}],"required":["report-type"],"properties":{"report-type":{"type":"string"}}},"Apache_Iceberg_REST_Catalog_API_ScanReport":{"type":"object","required":["table-name","snapshot-id","filter","schema-id","projected-field-ids","projected-field-names","metrics"],"properties":{"table-name":{"type":"string"},"snapshot-id":{"type":"integer","format":"int64"},"filter":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Expression"},"schema-id":{"type":"integer"},"projected-field-ids":{"type":"array","items":{"type":"integer"}},"projected-field-names":{"type":"array","items":{"type":"string"}},"metrics":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Metrics"},"metadata":{"type":"object","additionalProperties":{"type":"string"}}}},"Apache_Iceberg_REST_Catalog_API_CommitReport":{"type":"object","required":["table-name","snapshot-id","sequence-number","operation","metrics"],"properties":{"table-name":{"type":"string"},"snapshot-id":{"type":"integer","format":"int64"},"sequence-number":{"type":"integer","format":"int64"},"operation":{"type":"string"},"metrics":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Metrics"},"metadata":{"type":"object","additionalProperties":{"type":"string"}}}},"Apache_Iceberg_REST_Catalog_API_NotificationRequest":{"required":["notification-type"],"properties":{"notification-type":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_NotificationType"},"payload":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TableUpdateNotification"}}},"Apache_Iceberg_REST_Catalog_API_NotificationType":{"type":"string","enum":["UNKNOWN","CREATE","UPDATE","DROP"]},"Apache_Iceberg_REST_Catalog_API_TableUpdateNotification":{"type":"object","required":["table-name","timestamp","table-uuid","metadata-location"],"properties":{"table-name":{"type":"string"},"timestamp":{"type":"integer","format":"int64"},"table-uuid":{"type":"string"},"metadata-location":{"type":"string"},"metadata":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TableMetadata"}}},"Apache_Iceberg_REST_Catalog_API_OAuthError":{"type":"object","required":["error"],"properties":{"error":{"type":"string","enum":["invalid_request","invalid_client","invalid_grant","unauthorized_client","unsupported_grant_type","invalid_scope"]},"error_description":{"type":"string"},"error_uri":{"type":"string"}}},"Apache_Iceberg_REST_Catalog_API_OAuthTokenResponse":{"type":"object","required":["access_token","token_type"],"properties":{"access_token":{"type":"string","description":"The access token, for client credentials or token exchange"},"token_type":{"type":"string","enum":["bearer","mac","N_A"],"description":"Access token type for client credentials or token exchange\n\nSee https://datatracker.ietf.org/doc/html/rfc6749#section-7.1"},"expires_in":{"type":"integer","description":"Lifetime of the access token in seconds for client credentials or token exchange"},"issued_token_type":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TokenType"},"refresh_token":{"type":"string","description":"Refresh token for client credentials or token exchange"},"scope":{"type":"string","description":"Authorization scope for client credentials or token exchange"}}},"Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse":{"description":"JSON wrapper for all error responses (non-2xx)","type":"object","required":["error"],"properties":{"error":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ErrorModel"}},"additionalProperties":false,"example":{"error":{"message":"The server does not support this operation","type":"UnsupportedOperationException","code":406}}},"Apache_Iceberg_REST_Catalog_API_CreateNamespaceResponse":{"type":"object","required":["namespace"],"properties":{"namespace":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Namespace"},"properties":{"type":"object","additionalProperties":{"type":"string"},"description":"Properties stored on the namespace, if supported by the server.","example":{"owner":"Ralph","created_at":"1452120468"},"default":{}}}},"Apache_Iceberg_REST_Catalog_API_GetNamespaceResponse":{"type":"object","required":["namespace"],"properties":{"namespace":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Namespace"},"properties":{"type":"object","description":"Properties stored on the namespace, if supported by the server. If the server does not support namespace properties, it should return null for this field. If namespace properties are supported, but none are set, it should return an empty object.","additionalProperties":{"type":"string"},"example":{"owner":"Ralph","transient_lastDdlTime":"1452120468"},"default":{},"nullable":true}}},"Apache_Iceberg_REST_Catalog_API_ListTablesResponse":{"type":"object","properties":{"next-page-token":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_PageToken"},"identifiers":{"type":"array","uniqueItems":true,"items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TableIdentifier"}}}},"Apache_Iceberg_REST_Catalog_API_ListNamespacesResponse":{"type":"object","properties":{"next-page-token":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_PageToken"},"namespaces":{"type":"array","uniqueItems":true,"items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Namespace"}}}},"Apache_Iceberg_REST_Catalog_API_UpdateNamespacePropertiesResponse":{"type":"object","required":["updated","removed"],"properties":{"updated":{"description":"List of property keys that were added or updated","type":"array","uniqueItems":true,"items":{"type":"string"}},"removed":{"description":"List of properties that were removed","type":"array","items":{"type":"string"}},"missing":{"type":"array","items":{"type":"string"},"description":"List of properties requested for removal that were not found in the namespace's properties. Represents a partial success response. Server's do not need to implement this.","nullable":true}}},"Apache_Iceberg_REST_Catalog_API_CommitTableResponse":{"type":"object","required":["metadata-location","metadata"],"properties":{"metadata-location":{"type":"string"},"metadata":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TableMetadata"}}},"Apache_Iceberg_REST_Catalog_API_StatisticsFile":{"type":"object","required":["snapshot-id","statistics-path","file-size-in-bytes","file-footer-size-in-bytes","blob-metadata"],"properties":{"snapshot-id":{"type":"integer","format":"int64"},"statistics-path":{"type":"string"},"file-size-in-bytes":{"type":"integer","format":"int64"},"file-footer-size-in-bytes":{"type":"integer","format":"int64"},"blob-metadata":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BlobMetadata"}}}},"Apache_Iceberg_REST_Catalog_API_BlobMetadata":{"type":"object","required":["type","snapshot-id","sequence-number","fields"],"properties":{"type":{"type":"string"},"snapshot-id":{"type":"integer","format":"int64"},"sequence-number":{"type":"integer","format":"int64"},"fields":{"type":"array","items":{"type":"integer"}},"properties":{"type":"object"}}},"Apache_Iceberg_REST_Catalog_API_PartitionStatisticsFile":{"type":"object","required":["snapshot-id","statistics-path","file-size-in-bytes"],"properties":{"snapshot-id":{"type":"integer","format":"int64"},"statistics-path":{"type":"string"},"file-size-in-bytes":{"type":"integer","format":"int64"}}},"Apache_Iceberg_REST_Catalog_API_BooleanTypeValue":{"type":"boolean","example":true},"Apache_Iceberg_REST_Catalog_API_IntegerTypeValue":{"type":"integer","example":42},"Apache_Iceberg_REST_Catalog_API_LongTypeValue":{"type":"integer","format":"int64","example":9223372036854776000},"Apache_Iceberg_REST_Catalog_API_FloatTypeValue":{"type":"number","format":"float","example":3.14},"Apache_Iceberg_REST_Catalog_API_DoubleTypeValue":{"type":"number","format":"double","example":123.456},"Apache_Iceberg_REST_Catalog_API_DecimalTypeValue":{"type":"string","description":"Decimal type values are serialized as strings. Decimals with a positive scale serialize as numeric plain  text, while decimals with a negative scale use scientific notation and the exponent will be equal to the  negated scale. For instance, a decimal with a positive scale is '123.4500', with zero scale is '2',  and with a negative scale is '2E+20'","example":"123.4500"},"Apache_Iceberg_REST_Catalog_API_StringTypeValue":{"type":"string","example":"hello"},"Apache_Iceberg_REST_Catalog_API_UUIDTypeValue":{"type":"string","format":"uuid","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$","maxLength":36,"minLength":36,"description":"UUID type values are serialized as a 36-character lowercase string in standard UUID format as specified  by RFC-4122","example":"eb26bdb1-a1d8-4aa6-990e-da940875492c"},"Apache_Iceberg_REST_Catalog_API_DateTypeValue":{"type":"string","format":"date","description":"Date type values follow the 'YYYY-MM-DD' ISO-8601 standard date format","example":"2007-12-03"},"Apache_Iceberg_REST_Catalog_API_TimeTypeValue":{"type":"string","description":"Time type values follow the 'HH:MM:SS.ssssss' ISO-8601 format with microsecond precision","example":"22:31:08.123456"},"Apache_Iceberg_REST_Catalog_API_TimestampTypeValue":{"type":"string","description":"Timestamp type values follow the 'YYYY-MM-DDTHH:MM:SS.ssssss' ISO-8601 format with microsecond precision","example":"2007-12-03T10:15:30.123456"},"Apache_Iceberg_REST_Catalog_API_TimestampTzTypeValue":{"type":"string","description":"TimestampTz type values follow the 'YYYY-MM-DDTHH:MM:SS.ssssss+00:00' ISO-8601 format with microsecond precision,  and a timezone offset (+00:00 for UTC)","example":"2007-12-03T10:15:30.123456+00:00"},"Apache_Iceberg_REST_Catalog_API_TimestampNanoTypeValue":{"type":"string","description":"Timestamp_ns type values follow the 'YYYY-MM-DDTHH:MM:SS.sssssssss' ISO-8601 format with nanosecond precision","example":"2007-12-03T10:15:30.123456789"},"Apache_Iceberg_REST_Catalog_API_TimestampTzNanoTypeValue":{"type":"string","description":"Timestamp_ns type values follow the 'YYYY-MM-DDTHH:MM:SS.sssssssss+00:00' ISO-8601 format with nanosecond  precision, and a timezone offset (+00:00 for UTC)","example":"2007-12-03T10:15:30.123456789+00:00"},"Apache_Iceberg_REST_Catalog_API_FixedTypeValue":{"type":"string","description":"Fixed length type values are stored and serialized as an uppercase hexadecimal string  preserving the fixed length","example":"78797A"},"Apache_Iceberg_REST_Catalog_API_BinaryTypeValue":{"type":"string","description":"Binary type values are stored and serialized as an uppercase hexadecimal string","example":"78797A"},"Apache_Iceberg_REST_Catalog_API_CountMap":{"type":"object","properties":{"keys":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IntegerTypeValue"},"description":"List of integer column ids for each corresponding value"},"values":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_LongTypeValue"},"description":"List of Long values, matched to 'keys' by index"}},"example":{"keys":[1,2],"values":[100,200]}},"Apache_Iceberg_REST_Catalog_API_ValueMap":{"type":"object","properties":{"keys":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IntegerTypeValue"},"description":"List of integer column ids for each corresponding value"},"values":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_PrimitiveTypeValue"},"description":"List of primitive type values, matched to 'keys' by index"}},"example":{"keys":[1,2],"values":[100,"test"]}},"Apache_Iceberg_REST_Catalog_API_PrimitiveTypeValue":{"oneOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BooleanTypeValue"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IntegerTypeValue"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_LongTypeValue"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_FloatTypeValue"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_DoubleTypeValue"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_DecimalTypeValue"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_StringTypeValue"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_UUIDTypeValue"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_DateTypeValue"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TimeTypeValue"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TimestampTypeValue"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TimestampTzTypeValue"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TimestampNanoTypeValue"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TimestampTzNanoTypeValue"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_FixedTypeValue"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BinaryTypeValue"}]},"Apache_Iceberg_REST_Catalog_API_FileFormat":{"type":"string","enum":["avro","orc","parquet"]},"Apache_Iceberg_REST_Catalog_API_ContentFile":{"discriminator":{"propertyName":"content","mapping":{"data":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_DataFile","position-deletes":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_PositionDeleteFile","equality-deletes":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_EqualityDeleteFile"}},"type":"object","required":["spec-id","content","file-path","file-format","file-size-in-bytes","record-count"],"properties":{"content":{"type":"string"},"file-path":{"type":"string"},"file-format":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_FileFormat"},"spec-id":{"type":"integer"},"partition":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_PrimitiveTypeValue"},"description":"A list of partition field values ordered based on the fields of the partition spec specified by the  `spec-id`","example":[1,"bar"]},"file-size-in-bytes":{"type":"integer","format":"int64","description":"Total file size in bytes"},"record-count":{"type":"integer","format":"int64","description":"Number of records in the file"},"key-metadata":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BinaryTypeValue"}],"description":"Encryption key metadata blob"},"split-offsets":{"type":"array","items":{"type":"integer","format":"int64"},"description":"List of splittable offsets"},"sort-order-id":{"type":"integer"}}},"Apache_Iceberg_REST_Catalog_API_DataFile":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ContentFile"}],"type":"object","required":["content"],"properties":{"content":{"type":"string","enum":["data"]},"column-sizes":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_CountMap"}],"description":"Map of column id to total count, including null and NaN"},"value-counts":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_CountMap"}],"description":"Map of column id to null value count"},"null-value-counts":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_CountMap"}],"description":"Map of column id to null value count"},"nan-value-counts":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_CountMap"}],"description":"Map of column id to number of NaN values in the column"},"lower-bounds":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ValueMap"}],"description":"Map of column id to lower bound primitive type values"},"upper-bounds":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ValueMap"}],"description":"Map of column id to upper bound primitive type values"}}},"Apache_Iceberg_REST_Catalog_API_PositionDeleteFile":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ContentFile"}],"required":["content"],"properties":{"content":{"type":"string","enum":["position-deletes"]}}},"Apache_Iceberg_REST_Catalog_API_EqualityDeleteFile":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ContentFile"}],"required":["content"],"properties":{"content":{"type":"string","enum":["equality-deletes"]},"equality-ids":{"type":"array","items":{"type":"integer"},"description":"List of equality field IDs"}}}},"parameters":{"Apache_Iceberg_REST_Catalog_API_namespace":{"name":"namespace","in":"path","required":true,"description":"A namespace identifier as a single string. Multipart namespace parts should be separated by the unit separator (`0x1F`) byte.","schema":{"type":"string"},"examples":{"singlepart_namespace":{"value":"accounting"},"multipart_namespace":{"value":"accounting%1Ftax"}}},"Apache_Iceberg_REST_Catalog_API_prefix":{"name":"prefix","in":"path","schema":{"type":"string"},"required":true,"description":"An optional prefix in the path"},"Apache_Iceberg_REST_Catalog_API_table":{"name":"table","in":"path","description":"A table name","required":true,"schema":{"type":"string"},"example":"sales"},"Apache_Iceberg_REST_Catalog_API_view":{"name":"view","in":"path","description":"A view name","required":true,"schema":{"type":"string"},"example":"sales"},"Apache_Iceberg_REST_Catalog_API_data-access":{"name":"X-Iceberg-Access-Delegation","in":"header","description":"Optional signal to the server that the client supports delegated access via a comma-separated list of access mechanisms.  The server may choose to supply access via any or none of the requested mechanisms.\n\nSpecific properties and handling for `vended-credentials` is documented in the `LoadTableResult` schema section of this spec document.\n\nThe protocol and specification for `remote-signing` is documented in  the `s3-signer-open-api.yaml` OpenApi spec in the `aws` module.\n","required":false,"schema":{"type":"string","enum":["vended-credentials","remote-signing"]},"style":"simple","explode":false,"example":"vended-credentials,remote-signing"},"Apache_Iceberg_REST_Catalog_API_page-token":{"name":"pageToken","in":"query","required":false,"allowEmptyValue":true,"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_PageToken"}},"Apache_Iceberg_REST_Catalog_API_page-size":{"name":"pageSize","in":"query","description":"For servers that support pagination, this signals an upper bound of the number of results that a client will receive. For servers that do not support pagination, clients may receive results larger than the indicated `pageSize`.","required":false,"schema":{"type":"integer","minimum":1}}},"responses":{"Apache_Iceberg_REST_Catalog_API_OAuthTokenResponse":{"description":"OAuth2 token response for client credentials or token exchange","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_OAuthTokenResponse"}}}},"Apache_Iceberg_REST_Catalog_API_OAuthErrorResponse":{"description":"OAuth2 error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_OAuthError"}}}},"Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse":{"description":"Indicates a bad request error. It could be caused by an unexpected request body format or other forms of request validation failure, such as invalid json. Usually serves application/json content, although in some cases simple text/plain content might be returned by the server's middleware.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"example":{"error":{"message":"Malformed request","type":"BadRequestException","code":400}}}}},"Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse":{"description":"Unauthorized. Authentication is required and has failed or has not yet been provided.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"example":{"error":{"message":"Not authorized to make this request","type":"NotAuthorizedException","code":401}}}}},"Apache_Iceberg_REST_Catalog_API_ForbiddenResponse":{"description":"Forbidden. Authenticated user does not have the necessary permissions.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"example":{"error":{"message":"Not authorized to make this request","type":"NotAuthorizedException","code":403}}}}},"Apache_Iceberg_REST_Catalog_API_UnsupportedOperationResponse":{"description":"Not Acceptable / Unsupported Operation. The server does not support this operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ErrorModel"},"example":{"error":{"message":"The server does not support this operation","type":"UnsupportedOperationException","code":406}}}}},"Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse":{"description":"JSON wrapper for all error responses (non-2xx)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"example":{"error":{"message":"The server does not support this operation","type":"UnsupportedOperationException","code":406}}}}},"Apache_Iceberg_REST_Catalog_API_CreateNamespaceResponse":{"description":"Represents a successful call to create a namespace. Returns the namespace created, as well as any properties that were stored for the namespace, including those the server might have added. Implementations are not required to support namespace properties.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_CreateNamespaceResponse"},"example":{"namespace":["accounting","tax"],"properties":{"owner":"Ralph","created_at":"1452120468"}}}}},"Apache_Iceberg_REST_Catalog_API_GetNamespaceResponse":{"description":"Returns a namespace, as well as any properties stored on the namespace if namespace properties are supported by the server.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_GetNamespaceResponse"}}}},"Apache_Iceberg_REST_Catalog_API_ListTablesResponse":{"description":"A list of table identifiers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ListTablesResponse"},"examples":{"ListTablesResponseNonEmpty":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_ListTablesNonEmptyExample"},"ListTablesResponseEmpty":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_ListTablesEmptyExample"}}}}},"Apache_Iceberg_REST_Catalog_API_ListNamespacesResponse":{"description":"A list of namespaces","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ListNamespacesResponse"},"examples":{"NonEmptyResponse":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_ListNamespacesNonEmptyExample"},"EmptyResponse":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_ListNamespacesEmptyExample"}}}}},"Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse":{"description":"Credentials have timed out. If possible, the client should refresh credentials and retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"example":{"error":{"message":"Credentials have timed out","type":"AuthenticationTimeoutException","code":419}}}}},"Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse":{"description":"The service is not ready to handle the request. The client should wait and retry.\n\nThe service may additionally send a Retry-After header to indicate when to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"example":{"error":{"message":"Slow down","type":"SlowDownException","code":503}}}}},"Apache_Iceberg_REST_Catalog_API_ServerErrorResponse":{"description":"A server-side problem that might not be addressable from the client side. Used for server 5xx errors without more specific documentation in individual routes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"example":{"error":{"message":"Internal Server Error","type":"InternalServerError","code":500}}}}},"Apache_Iceberg_REST_Catalog_API_UpdateNamespacePropertiesResponse":{"description":"JSON data response for a synchronous update properties request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_UpdateNamespacePropertiesResponse"},"example":{"updated":["owner"],"removed":["foo"],"missing":["bar"]}}}},"Apache_Iceberg_REST_Catalog_API_CreateTableResponse":{"description":"Table metadata result after creating a table","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_LoadTableResult"}}}},"Apache_Iceberg_REST_Catalog_API_LoadTableResponse":{"description":"Table metadata result when loading a table","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_LoadTableResult"}}}},"Apache_Iceberg_REST_Catalog_API_LoadViewResponse":{"description":"View metadata result when loading a view","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_LoadViewResult"}}}},"Apache_Iceberg_REST_Catalog_API_CommitTableResponse":{"description":"Response used when a table is successfully updated.\nThe table metadata JSON is returned in the metadata field. The corresponding file location of table metadata must be returned in the metadata-location field. Clients can check whether metadata has changed by comparing metadata locations.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_CommitTableResponse"}}}}},"examples":{"Apache_Iceberg_REST_Catalog_API_ListTablesEmptyExample":{"summary":"An empty list for a namespace with no tables","value":{"identifiers":[]}},"Apache_Iceberg_REST_Catalog_API_ListNamespacesEmptyExample":{"summary":"An empty list of namespaces","value":{"namespaces":[]}},"Apache_Iceberg_REST_Catalog_API_ListNamespacesNonEmptyExample":{"summary":"A non-empty list of namespaces","value":{"namespaces":[["accounting","tax"],["accounting","credits"]]}},"Apache_Iceberg_REST_Catalog_API_ListTablesNonEmptyExample":{"summary":"A non-empty list of table identifiers","value":{"identifiers":[{"namespace":["accounting","tax"],"name":"paid"},{"namespace":["accounting","tax"],"name":"owed"}]}},"Apache_Iceberg_REST_Catalog_API_MultipartNamespaceAsPathVariable":{"summary":"A multi-part namespace, as represented in a path parameter","value":"accounting%1Ftax"},"Apache_Iceberg_REST_Catalog_API_NamespaceAsPathVariable":{"summary":"A single part namespace, as represented in a path paremeter","value":"accounting"},"Apache_Iceberg_REST_Catalog_API_NamespaceAlreadyExistsError":{"summary":"The requested namespace already exists","value":{"error":{"message":"The given namespace already exists","type":"AlreadyExistsException","code":409}}},"Apache_Iceberg_REST_Catalog_API_NoSuchTableError":{"summary":"The requested table does not exist","value":{"error":{"message":"The given table does not exist","type":"NoSuchTableException","code":404}}},"Apache_Iceberg_REST_Catalog_API_NoSuchViewError":{"summary":"The requested view does not exist","value":{"error":{"message":"The given view does not exist","type":"NoSuchViewException","code":404}}},"Apache_Iceberg_REST_Catalog_API_NoSuchNamespaceError":{"summary":"The requested namespace does not exist","value":{"error":{"message":"The given namespace does not exist","type":"NoSuchNamespaceException","code":404}}},"Apache_Iceberg_REST_Catalog_API_RenameTableSameNamespace":{"summary":"Rename a table in the same namespace","value":{"source":{"namespace":["accounting","tax"],"name":"paid"},"destination":{"namespace":["accounting","tax"],"name":"owed"}}},"Apache_Iceberg_REST_Catalog_API_RenameViewSameNamespace":{"summary":"Rename a view in the same namespace","value":{"source":{"namespace":["accounting","tax"],"name":"paid-view"},"destination":{"namespace":["accounting","tax"],"name":"owed-view"}}},"Apache_Iceberg_REST_Catalog_API_TableAlreadyExistsError":{"summary":"The requested table identifier already exists","value":{"error":{"message":"The given table already exists","type":"AlreadyExistsException","code":409}}},"Apache_Iceberg_REST_Catalog_API_ViewAlreadyExistsError":{"summary":"The requested view identifier already exists","value":{"error":{"message":"The given view already exists","type":"AlreadyExistsException","code":409}}},"Apache_Iceberg_REST_Catalog_API_UnprocessableEntityDuplicateKey":{"summary":"The request body either has the same key multiple times in what should be a map with unique keys or the request body has keys in two or more fields which should be disjoint sets.","value":{"error":{"message":"The request cannot be processed as there is a key present multiple times","type":"UnprocessableEntityException","code":422}}},"Apache_Iceberg_REST_Catalog_API_UpdateAndRemoveNamespacePropertiesRequest":{"summary":"An update namespace properties request with both properties to remove and properties to upsert.","value":{"removals":["foo","bar"],"updates":{"owner":"Raoul"}}}}},"x-tagGroups":[{"name":"Apache Polaris (Incubating) Documentation","tags":["Overview","Polaris Entities","Access Control","Configuring Polaris for Production"]},{"name":"Polaris Management Service","tags":["polaris-management-service_other"]},{"name":"Apache Iceberg REST Catalog API","tags":["Configuration API","OAuth2 API","Catalog API"]}]}},"searchIndex":{"store":["section/Quick-Start","section/Quick-Start/Prerequisites","section/Quick-Start/Deploying-Polaris","section/Quick-Start/Bootstrapping-Polaris","section/Quick-Start/Defining-a-Catalog","section/Quick-Start/Using-Iceberg-and-Polaris","tag/Overview","tag/Overview/Key-concepts","tag/Overview/Example-workflow","tag/Overview/Security-and-access-control","tag/Overview/Legal-Notices","tag/Polaris-Entities","tag/Polaris-Entities/Catalog","tag/Polaris-Entities/Namespace","tag/Polaris-Entities/Table","tag/Polaris-Entities/View","tag/Polaris-Entities/Principal","tag/Polaris-Entities/Principal-Role","tag/Polaris-Entities/Catalog-Role","tag/Polaris-Entities/Privilege","tag/Access-Control","tag/Access-Control/Securable-object","tag/Access-Control/Principal-role","tag/Access-Control/Catalog-role","tag/Access-Control/RBAC-model","tag/Access-Control/Access-control-privileges","tag/Access-Control/RBAC-example","tag/Configuring-Polaris-for-Production","tag/Configuring-Polaris-for-Production/Configuring-Apache-Polaris-(Incubating)-for-Production","tag/Configuring-Polaris-for-Production/Configuring-Apache-Polaris-(Incubating)-for-Production/Security","tag/Configuring-Polaris-for-Production/Configuring-Apache-Polaris-(Incubating)-for-Production/Metastore-Management","tag/Configuring-Polaris-for-Production/Configuring-Apache-Polaris-(Incubating)-for-Production/Other-Configurations","tag/polaris-management-service_other","tag/polaris-management-service_other/operation/listCatalogs","tag/polaris-management-service_other/operation/createCatalog","tag/polaris-management-service_other/operation/getCatalog","tag/polaris-management-service_other/operation/updateCatalog","tag/polaris-management-service_other/operation/deleteCatalog","tag/polaris-management-service_other/operation/listPrincipals","tag/polaris-management-service_other/operation/createPrincipal","tag/polaris-management-service_other/operation/getPrincipal","tag/polaris-management-service_other/operation/updatePrincipal","tag/polaris-management-service_other/operation/deletePrincipal","tag/polaris-management-service_other/operation/rotateCredentials","tag/polaris-management-service_other/operation/listPrincipalRolesAssigned","tag/polaris-management-service_other/operation/assignPrincipalRole","tag/polaris-management-service_other/operation/revokePrincipalRole","tag/polaris-management-service_other/operation/listPrincipalRoles","tag/polaris-management-service_other/operation/createPrincipalRole","tag/polaris-management-service_other/operation/getPrincipalRole","tag/polaris-management-service_other/operation/updatePrincipalRole","tag/polaris-management-service_other/operation/deletePrincipalRole","tag/polaris-management-service_other/operation/listAssigneePrincipalsForPrincipalRole","tag/polaris-management-service_other/operation/listCatalogRolesForPrincipalRole","tag/polaris-management-service_other/operation/assignCatalogRoleToPrincipalRole","tag/polaris-management-service_other/operation/revokeCatalogRoleFromPrincipalRole","tag/polaris-management-service_other/operation/listCatalogRoles","tag/polaris-management-service_other/operation/createCatalogRole","tag/polaris-management-service_other/operation/getCatalogRole","tag/polaris-management-service_other/operation/updateCatalogRole","tag/polaris-management-service_other/operation/deleteCatalogRole","tag/polaris-management-service_other/operation/listAssigneePrincipalRolesForCatalogRole","tag/polaris-management-service_other/operation/listGrantsForCatalogRole","tag/polaris-management-service_other/operation/addGrantToCatalogRole","tag/polaris-management-service_other/operation/revokeGrantFromCatalogRole","tag/Configuration-API","tag/Configuration-API/operation/getConfig","tag/OAuth2-API","tag/OAuth2-API/operation/getToken","tag/Catalog-API","tag/Catalog-API/operation/listNamespaces","tag/Catalog-API/operation/createNamespace","tag/Catalog-API/operation/loadNamespaceMetadata","tag/Catalog-API/operation/namespaceExists","tag/Catalog-API/operation/dropNamespace","tag/Catalog-API/operation/updateProperties","tag/Catalog-API/operation/listTables","tag/Catalog-API/operation/createTable","tag/Catalog-API/operation/registerTable","tag/Catalog-API/operation/loadTable","tag/Catalog-API/operation/updateTable","tag/Catalog-API/operation/dropTable","tag/Catalog-API/operation/tableExists","tag/Catalog-API/operation/renameTable","tag/Catalog-API/operation/reportMetrics","tag/Catalog-API/operation/sendNotification","tag/Catalog-API/operation/commitTransaction","tag/Catalog-API/operation/listViews","tag/Catalog-API/operation/createView","tag/Catalog-API/operation/loadView","tag/Catalog-API/operation/replaceView","tag/Catalog-API/operation/dropView","tag/Catalog-API/operation/viewExists","tag/Catalog-API/operation/renameView"],"index":{"version":"2.3.9","fields":["title","description"],"fieldVectors":[["title/0",[0,4.358,1,2.667]],["description/0",[2,4.352,3,5.469,4,5.469,5,4.352,6,3.036,7,2.23,8,2.23,9,2.886,10,1.534,11,3.182,12,4.352,13,4.352,14,3.182,15,3.347,16,4.352,17,2.784,18,2.157,19,1.374,20,3.756]],["title/1",[21,4.715]],["description/1",[1,1.201,2,2.57,8,0.8,9,1.737,10,1.438,13,3.275,14,2.395,15,1.976,18,1.274,19,1.631,21,3.609,22,1.962,23,2.374,24,3.229,25,1.442,26,1.962,27,1.561,28,2.832,29,1.201,30,1.962,31,2.519,32,2.832,33,1.442,34,0.8,35,1.442,36,2.259,37,1.962,38,1.962,39,4.116,40,3.084,41,4.974,42,1.962,43,3.229,44,6.685,45,5.997,46,4.77,47,3.896,48,5.274,49,1.962,50,3.796,51,1.962,52,4.183,53,4.116,54,1.442,55,1.561,56,1.962,57,1.962,58,1.268,59,2.832,60,1.089,61,2.832,62,1.962,63,1.962,64,2.57,65,1.72,66,1.962,67,3.229,68,3.275,69,4.116,70,1.962,71,1.962,72,1.201,73,2.088,74,0.622,75,4.77,76,3.229,77,1.268,78,1.962,79,1.792,80,1.72,81,2.088,82,1.041,83,1.041,84,0.923,85,1.561,86,1.561,87,1.442,88,4.197,89,1.962,90,1.962,91,1.141,92,1.962,93,1.72,94,1.72,95,1.962,96,1.962,97,1.72]],["title/2",[10,0.896,14,2.536]],["description/2",[1,4.308,10,1.524,13,4.292,14,1.726,15,1.815,19,0.745,23,2.181,29,1.815,31,1.815,32,2.601,33,2.181,36,2.52,47,3.075,50,3.563,52,5.654,58,1.918,60,2.993,98,2.966,99,4.477,100,2.966,101,2.181,102,2.966,103,2.966,104,1.815,105,2.181,106,2.181,107,2.966,108,2.966,109,2.966,110,4.292,111,2.966,112,1.575,113,2.966,114,2.181,115,2.966,116,2.966,117,2.966,118,2.276,119,2.966,120,2.36,121,2.966,122,2.966,123,1.17,124,2.966,125,2.966,126,2.966,127,1.45,128,6.007,129,5.268,130,2.966,131,2.966,132,4.477,133,2.037,134,2.601,135,2.966,136,1.646,137,2.037]],["title/3",[10,0.896,138,3.204]],["description/3",[7,2.143,10,1.506,18,1.455,19,1.538,31,2.258,36,1.94,47,2.534,55,2.936,74,1.17,87,2.713,106,3.863,114,2.713,118,1.557,123,1.455,138,2.713,139,3.69,140,5.255,141,3.69,142,2.048,143,4.182,144,4.608,145,3.69,146,3.69,147,3.236,148,3.69,149,5.367,150,3.316,151,1.613,152,2.258,153,2.936,154,3.69,155,3.69,156,1.178,157,3.69,158,3.69,159,2.936,160,3.69,161,2.936,162,3.69,163,3.69,164,2.713,165,1.613,166,3.69,167,3.69,168,2.936,169,5.255,170,3.69,171,3.69]],["title/4",[114,3.204,172,0.584]],["description/4",[7,1.45,8,0.9,10,1.296,18,0.871,19,0.555,23,0.923,25,0.923,29,0.769,31,1.351,36,2.587,47,2.442,50,0.999,58,0.812,60,1.225,74,0.398,82,1.172,86,2.351,104,1.351,118,0.932,120,0.999,123,0.871,142,0.697,147,1.101,150,1.905,151,0.549,156,1.494,164,0.923,165,0.549,168,2.351,172,0.961,173,1.256,174,0.923,175,1.285,176,1.256,177,1.256,178,1.101,179,1.225,180,0.512,181,2.511,182,4.222,183,4.222,184,4.222,185,4.222,186,1.256,187,1.757,188,1.256,189,2.208,190,1.256,191,2.208,192,3.551,193,1.64,194,0.923,195,2.478,196,0.769,197,1.285,198,1,199,1.256,200,1.026,201,1.427,202,0.731,203,0.965,204,0.769,205,0.999,206,0.999,207,0.697,208,1.256,209,1.351,210,1.64,211,0.731,212,0.999,213,1.256,214,0.812,215,1.256,216,1.256,217,0.923,218,1.256,219,1.101,220,0.697,221,1.256,222,2.208,223,2.954,224,1.256,225,1.256,226,0.812,227,0.769,228,2.208,229,2.208,230,1.172,231,1.672,232,1.256,233,0.862,234,1.256,235,1.936,236,2.351,237,2.954,238,2.591,239,2.591,240,1.256,241,1.101,242,1.101,243,1.256,244,0.731,245,1.256,246,1.256,247,1.101,248,1.256,249,1.101,250,1.936,251,1.838,252,1.256,253,1.256,254,2.954,255,0.999,256,1.101,257,1.256,258,0.862,259,2.208,260,1.757,261,2.208,262,1.256,263,1.256,264,1.101,265,2.351,266,1.256,267,0.999,268,1.256,269,2.208,270,0.697,271,0.769,272,0.495,273,1.101]],["title/5",[10,0.649,19,0.794,36,1.002,274,1.754]],["description/5",[1,1.014,2,1.319,8,0.676,9,1.539,10,0.75,15,1.014,16,1.319,17,1.428,19,1.528,28,1.453,31,2.232,35,2.062,36,2.6,41,1.453,47,1.926,58,1.071,60,2.024,74,1.156,79,0.92,80,1.453,81,1.814,83,0.88,84,0.779,85,1.319,88,4.645,93,1.453,94,1.453,97,1.453,105,1.218,120,1.319,127,0.81,136,0.92,137,1.138,142,0.92,149,1.453,150,0.779,156,1.075,164,1.218,168,1.319,172,0.782,181,1.75,182,1.453,183,1.453,184,1.453,185,1.453,192,2.46,195,0.92,200,1.266,203,2.098,204,1.014,206,1.319,214,1.071,219,1.453,231,0.779,235,2.46,238,1.453,239,1.453,241,1.453,247,1.453,249,1.453,250,2.46,251,0.633,256,1.453,260,1.319,265,1.319,270,0.92,272,0.962,274,1.557,275,1.319,276,1.657,277,1.657,278,1.657,279,3.647,280,1.657,281,3.647,282,1.657,283,1.657,284,1.657,285,1.657,286,1.657,287,6.081,288,1.657,289,1.657,290,1.657,291,1.657,292,1.657,293,1.657,294,1.657,295,1.657,296,1.657,297,1.319,298,3.155,299,1.319,300,1.453,301,1.657,302,1.657,303,0.81,304,1.657,305,1.172,306,1.319,307,1.453,308,2.805,309,2.805,310,1.392,311,1.657,312,2.805,313,1.657,314,2.805,315,1.657,316,1.657,317,1.657,318,1.138,319,2.232,320,2.805,321,2.805,322,2.062,323,1.657,324,1.657,325,1.657,326,2.805,327,1.319,328,1.657,329,1.657,330,1.453,331,1.657,332,1.657]],["title/6",[333,4.715]],["description/6",[9,2.975,10,1.238,11,2.616,19,0.749,36,1.425,61,2.615,65,2.615,73,1.928,83,1.583,118,1.897,123,1.176,133,2.048,151,1.303,172,0.399,179,3.344,195,1.655,200,1.036,201,1.928,202,2.616,204,1.825,214,1.928,274,1.655,305,1.098,333,2.615,334,5.563,335,3.088,336,2.048,337,3.305,338,1.403,339,1.928,340,2.193,341,2.048,342,2.545,343,3.978,344,1.928,345,1.735,346,2.193,347,2.193,348,2.193,349,2.193,350,2.048,351,2.193,352,2.193,353,2.193,354,2.193,355,2.193,356,1.655,357,2.193,358,2.193,359,2.193,360,1.928,361,2.193,362,2.048,363,2.193,364,2.193,365,2.193,366,1.928,367,2.193,368,2.048,369,1.825,370,2.193,371,1.735,372,3.305,373,2.982,374,2.982,375,2.615,376,1.458,377,2.615,378,2.373,379,2.982,380,2.048,381,2.982]],["title/7",[6,2.419,382,3.468]],["description/7",[6,0.363,7,0.699,8,0.877,9,1.999,10,1.309,11,1.252,17,0.332,18,1.138,19,0.939,20,0.837,23,0.48,36,2.472,40,0.422,60,1.194,64,0.52,72,0.4,73,0.422,74,1.014,79,2.536,81,0.788,82,0.347,88,0.52,101,0.48,112,0.347,114,0.48,118,1.218,123,1.138,127,1.702,137,0.449,142,1.194,150,0.307,151,1.11,156,1.327,165,0.533,172,0.939,174,0.48,175,0.38,178,1.069,179,0.677,180,2.416,181,1.788,187,2.02,193,2.205,195,1.194,197,1.252,198,1.129,200,1.002,201,1.642,202,0.709,203,1.521,204,1.766,207,0.951,209,2.995,210,0.677,211,0.38,212,2.02,231,1.504,233,0.449,251,1.598,258,0.837,267,0.52,270,0.363,271,0.4,272,0.938,274,2.324,275,2.975,298,0.896,299,0.52,300,1.503,303,0.319,305,1.6,310,0.821,318,0.837,338,0.806,342,0.573,344,0.422,345,0.38,362,0.449,372,2.122,376,0.596,377,0.573,378,2.297,380,1.177,382,0.52,383,0.653,384,0.38,385,1.219,386,0.653,387,2.02,388,0.653,389,0.653,390,0.573,391,0.653,392,0.653,393,0.449,394,0.653,395,1.219,396,1.219,397,3.278,398,0.573,399,0.653,400,0.653,401,0.653,402,0.653,403,0.653,404,1.477,405,1.504,406,2.151,407,0.422,408,0.746,409,0.573,410,0.422,411,0.52,412,0.38,413,0.653,414,0.653,415,0.48,416,1.069,417,1.219,418,0.52,419,2.77,420,0.653,421,0.653,422,0.653,423,1.714,424,0.48,425,0.653,426,1.886,427,0.97,428,1.712,429,1.069,430,0.4,431,0.653,432,0.653,433,0.48,434,0.573,435,0.653,436,0.653,437,1.714,438,0.573,439,1.714,440,0.52,441,0.653,442,0.573,443,1.714,444,1.219,445,0.653,446,0.653,447,0.746,448,0.653,449,0.52,450,0.573,451,0.52,452,0.653,453,1.219,454,1.069,455,0.573,456,1.219,457,2.151,458,1.069,459,0.653,460,1.714,461,1.219,462,1.219,463,0.653,464,0.97,465,0.653,466,0.573,467,1.642,468,0.653,469,0.52,470,0.709,471,1.766,472,1.108,473,0.573,474,0.653,475,0.653,476,0.653,477,0.653,478,0.332,479,0.52,480,0.573,481,0.653,482,0.48,483,1.069,484,0.573,485,0.653,486,0.653,487,0.48,488,0.48,489,0.653,490,1.714,491,1.714,492,1.364,493,1.219,494,0.653,495,0.653,496,0.653,497,0.653,498,1.219,499,0.653,500,0.653,501,0.653,502,0.653]],["title/8",[18,1.719,503,3.821]],["description/8",[9,2.699,10,1.012,11,1.961,18,2.294,19,1.607,20,2.315,79,2.732,127,1.648,156,1.103,172,0.659,179,1.871,180,2.608,181,2.608,201,4.135,203,2.973,231,2.315,272,0.755,305,1.42,318,2.315,319,2.682,372,2.478,380,2.315,390,2.955,393,2.315,408,2.063,410,3.183,419,3.917,442,2.955,503,5.099,504,5.099,505,7.521,506,5.608,507,4.923,508,4.316,509,2.955,510,2.682,511,3.37,512,3.37]],["title/9",[200,1.272,376,1.791,470,2.131]],["description/9",[7,1.541,8,1.541,10,1.427,12,1.896,19,1.18,25,1.751,36,1.847,60,1.322,74,1.489,79,2.097,101,1.751,118,1.005,123,0.94,142,1.322,150,2.514,151,1.041,156,1.306,172,0.629,180,2.376,194,1.751,197,1.386,198,1.306,200,2.564,203,1.041,204,2.874,207,1.322,209,3.271,210,1.322,214,1.54,231,1.777,233,1.636,251,1.792,272,0.534,274,2.097,275,1.896,305,1.423,342,1.12,356,1.322,360,1.54,368,1.636,375,2.089,376,2.613,378,4.934,397,2.089,405,1.777,415,1.751,430,1.458,434,2.089,469,1.896,470,3.608,471,2.312,472,1.54,473,2.089,482,2.778,483,4.117,484,2.089,513,4.695,514,2.382,515,2.382,516,1.54,517,2.382,518,2.382,519,2.382,520,2.089,521,2.089,522,2.382,523,2.382,524,2.382,525,2.382,526,1.751,527,1.896]],["title/10",[341,2.993,528,4.358]],["description/10",[9,3.348,20,3.913,335,3.913,336,3.913,372,4.189,430,3.487,454,6.152,529,5.698,530,7.016,531,5.698,532,4.996,533,4.996,534,5.698]],["title/11",[7,1.777,10,0.896]],["description/11",[7,1.446,8,1.446,9,2.526,10,0.729,11,2.063,19,0.891,36,1.619,73,2.292,118,2.155,123,1.398,133,2.435,151,1.55,179,3.635,202,2.063,255,2.822,334,5.797,335,3.508,336,2.435,337,3.755,338,1.668,339,2.292,340,2.607,341,2.435,342,2.815,343,4.401,344,2.292,345,2.063,346,2.607,347,2.607,348,2.607,349,2.607,350,2.435,351,2.607,352,2.607,353,2.607,354,2.607,355,2.607,356,1.968,357,2.607,358,2.607,359,2.607,360,2.292,361,2.607,362,2.435,363,2.607,364,2.607,365,2.607,366,2.292,367,2.607,368,2.435,369,2.17,370,2.607,535,3.546,536,3.109]],["title/12",[172,0.72]],["description/12",[7,2.063,8,1.427,9,1.477,10,1.04,17,1.782,19,1.271,36,1.11,54,2.573,74,1.11,83,2.686,84,3.062,85,2.785,104,2.142,112,1.858,118,2.135,123,1.38,150,1.646,151,2.211,165,1.53,172,0.994,174,2.573,187,2.785,195,1.943,200,1.215,203,2.597,209,4.227,210,3.995,212,2.785,214,2.263,217,2.573,270,1.943,274,1.943,342,1.646,384,2.944,407,2.263,426,3.069,447,2.142,536,3.069,537,3.5,538,3.069,539,3.069,540,3.5,541,3.5,542,3.5,543,3.5,544,2.404,545,3.069,546,2.573,547,3.5,548,2.785,549,3.5]],["title/13",[272,1.205]],["description/13",[7,2.52,8,1.905,10,0.96,18,1.842,83,2.48,84,2.907,86,3.717,112,2.48,118,1.971,123,1.842,151,2.701,203,2.042,211,2.718,270,3.43,272,1.765,384,2.718,387,3.717,427,3.717,526,3.434,538,4.096,544,3.208,548,4.917,550,4.671,551,4.671,552,4.671,553,4.671,554,4.671,555,4.671,556,4.671]],["title/14",[305,1.313]],["description/14",[7,2.276,8,2.276,9,2.355,10,1.147,83,2.963,84,3.258,118,2.355,123,2.201,151,3.027,203,2.439,274,3.098,305,1.839,384,3.247,407,3.608,557,5.581,558,5.581]],["title/15",[559,2.053]],["description/15",[7,2.276,8,2.276,9,2.355,10,1.147,83,2.963,84,3.258,118,2.355,123,2.201,151,3.027,203,2.439,274,3.098,384,3.247,407,3.608,559,2.875,560,5.581,561,5.581]],["title/16",[156,1.205]],["description/16",[7,2.008,8,2.008,10,1.012,19,1.237,83,2.615,84,3.009,118,2.078,123,2.523,151,2.796,156,1.747,172,0.66,180,2.008,200,1.71,203,2.152,230,2.615,270,2.734,338,2.316,384,2.866,447,3.014,451,3.919,466,4.318,482,3.621,562,4.925,563,3.621,564,4.318,565,4.925]],["title/17",[156,0.976,198,0.976]],["description/17",[7,1.768,8,1.768,10,1.208,40,2.804,72,2.654,83,2.302,84,2.765,118,1.83,123,2.319,151,2.57,156,1.842,198,1.727,200,1.506,203,1.895,214,2.804,230,2.302,251,2.244,270,2.407,271,2.654,338,2.04,384,2.523,447,2.654,492,3.451,566,3.802,567,4.336,568,4.336,569,2.654,570,2.04,571,4.336]],["title/18",[172,0.584,198,0.976]],["description/18",[7,1.662,10,0.838,40,2.636,54,2.997,72,3.449,123,2.223,156,1.263,172,1.088,180,1.662,198,1.695,200,1.957,203,2.463,211,2.372,230,2.164,251,2.792,271,2.495,272,0.913,305,0.995,338,2.651,428,3.244,447,3.953,492,3.244,548,3.244,563,2.997,564,3.575,566,3.575,572,4.077,573,4.077,574,4.077,575,4.077]],["title/19",[231,2.529]],["description/19",[7,1.58,10,0.796,17,1.972,34,1.58,36,2.161,54,2.848,55,3.082,82,2.057,84,1.822,118,1.635,156,1.609,172,1.045,198,1.668,200,1.345,231,3.501,251,2.74,258,2.66,272,0.868,305,0.946,447,2.371,559,1.479,570,2.558,576,3.874,577,3.874,578,4.769,579,3.397,580,3.874,581,3.874,582,3.874,583,3.874,584,3.874,585,3.874,586,3.874]],["title/20",[200,1.513,470,2.536]],["description/20",[6,1.545,9,2.189,10,1.195,11,1.62,19,1.072,36,2.097,73,1.8,118,1.8,123,1.098,133,1.912,151,1.865,156,1.162,172,0.695,175,1.62,179,3.228,180,1.135,195,1.545,198,1.405,200,2.177,202,1.62,207,1.545,230,2.265,231,2.007,233,1.912,251,1.063,334,5.465,335,2.93,336,1.912,337,3.137,338,1.31,339,1.8,340,2.047,341,1.912,342,2.44,343,3.814,344,2.759,345,1.62,346,2.047,347,2.047,348,2.047,349,2.047,350,1.912,351,2.047,352,2.047,353,2.047,354,2.047,355,2.047,356,1.545,357,2.047,358,2.047,359,2.047,360,1.8,361,2.047,362,1.912,363,2.047,364,2.047,365,2.047,366,1.8,367,2.047,368,1.912,369,1.704,370,2.047,376,1.361,382,2.216,467,1.8,469,2.216,470,3.018,471,1.704,472,1.8,587,2.784]],["title/21",[175,2.536,376,2.13]],["description/21",[10,1.171,36,2.515,127,2.786,172,0.763,175,4.423,200,1.978,251,2.175,272,1.277,274,3.163,305,1.391,376,3.43,559,2.175]],["title/22",[156,0.976,198,0.976]],["description/22",[10,1.286,18,1.676,19,0.696,36,2.459,60,2.359,72,3.165,74,1.347,79,1.538,82,1.471,127,1.354,156,1.802,172,0.569,175,2.473,180,2.966,198,1.738,203,1.857,204,1.695,206,2.204,207,1.538,220,1.538,231,2.432,251,2.776,267,2.204,271,1.695,305,0.676,338,1.303,369,1.695,376,1.354,393,1.902,408,1.695,427,2.204,428,2.204,430,1.695,438,2.429,458,3.727,464,2.204,467,1.791,487,2.036,488,2.036,539,2.429,588,2.429,589,2.77,590,2.204,591,2.204,592,2.204,593,2.429,594,2.429,595,2.77]],["title/23",[172,0.584,198,0.976]],["description/23",[10,0.868,18,1.312,36,2.482,72,1.245,74,0.645,82,1.08,110,2.648,123,1.924,127,0.995,144,1.784,156,1.516,164,1.496,165,0.889,172,1.055,175,1.184,180,1.722,181,1.357,198,1.765,200,1.466,201,3.153,202,2.457,207,1.13,211,1.184,220,1.13,226,1.316,231,2.99,251,2.646,271,1.245,272,0.456,303,2.064,305,1.488,322,1.496,338,2.715,339,1.316,369,1.245,410,1.316,412,1.184,424,1.496,429,2.918,450,1.784,467,1.316,480,2.918,487,1.496,488,1.496,508,1.784,516,2.152,592,1.619,596,2.035,597,3.328,598,3.328,599,2.918,600,3.328,601,2.035,602,2.035,603,2.035,604,4.222,605,4.222,606,2.035,607,2.035,608,1.316,609,1.784]],["title/24",[471,2.667,472,2.817]],["description/24",[9,2.522,10,1.484,19,1.116,82,2.359,127,2.172,156,1.618,172,0.905,180,2.437,198,1.618,200,2.075,207,2.466,230,3.173,231,2.09,251,1.696,380,4.104,393,3.051,447,2.719,467,2.872,471,4.133,472,4.366,487,3.266,488,3.266,588,3.896,610,3.896,611,4.443]],["title/25",[200,1.272,231,1.723,470,2.131]],["description/25",[8,0.897,10,0.452,12,0.995,17,1.119,18,0.493,19,0.314,34,1.647,36,2.742,40,0.808,74,1.124,127,0.611,150,1.034,156,0.905,165,0.546,172,0.976,175,2.062,180,0.897,181,0.51,198,1.144,200,0.763,201,3.105,202,1.279,203,0.961,209,1.346,220,0.694,226,2.291,227,0.765,231,3.224,233,0.859,251,2.284,260,1.75,264,1.096,265,0.995,272,1.203,305,1.501,322,1.617,350,0.859,387,0.995,398,6.156,410,0.808,412,0.727,424,0.919,430,1.346,433,0.919,470,1.279,472,0.808,545,1.928,559,1.833,578,1.928,591,0.995,592,2.82,608,2.291,612,1.25,613,2.199,614,1.096,615,1.25,616,1.25,617,1.25,618,1.25,619,2.199,620,1.25,621,2.199,622,2.199,623,2.199,624,1.25,625,1.25,626,1.25,627,1.25,628,1.25,629,1.25,630,2.725,631,1.25,632,1.25,633,1.25,634,1.25,635,1.25,636,1.25,637,1.25,638,1.25,639,1.25,640,1.25,641,1.25,642,1.25,643,1.25,644,1.25]],["title/26",[18,1.719,471,2.667]],["description/26",[9,2.028,10,1.294,17,1.257,18,1.533,19,0.976,20,1.695,25,2.857,36,2.164,74,0.783,79,1.37,110,1.964,127,2.665,134,2.165,156,1.328,172,1.012,180,2.418,181,2.418,198,1.476,200,1.349,203,2.382,204,1.511,207,1.37,226,1.596,251,2.515,272,0.871,305,0.603,339,2.512,344,2.512,369,1.511,380,3.301,393,1.695,408,2.378,419,3.092,424,1.815,455,2.165,464,1.964,467,3.107,470,1.436,471,2.941,504,3.408,506,4.78,563,1.815,579,3.408,593,2.165,594,2.165,609,3.408,610,2.165,645,2.469,646,2.469,647,1.964,648,3.886,649,4.806,650,5.929,651,2.469,652,2.469,653,3.886,654,2.469,655,2.469]],["title/27",[10,0.753,74,1.161,152,2.242]],["description/27",[5,1.053,6,0.734,7,1.255,8,2.142,9,1.298,10,1.29,11,0.77,14,1.79,15,1.414,19,1.537,27,1.053,29,0.81,31,0.81,33,0.973,35,0.973,36,2.39,58,0.855,60,0.734,68,1.839,73,0.855,74,2.114,79,0.734,87,1.699,105,0.973,106,0.973,112,0.702,118,0.975,123,0.522,127,0.647,133,0.909,136,0.734,137,0.909,138,3.078,142,1.283,143,1.839,150,0.622,151,1.01,152,2.563,153,1.053,161,1.053,165,1.345,172,0.31,179,2.047,180,0.942,196,1.883,197,0.77,202,0.77,205,1.839,209,1.414,210,1.283,211,0.77,217,0.973,220,2.047,227,1.414,258,0.909,306,1.053,310,0.505,334,4.22,335,1.587,336,0.909,337,1.699,338,0.622,339,0.855,340,0.973,341,0.909,342,1.969,343,2.262,344,0.855,345,0.77,346,0.973,347,0.973,348,0.973,349,0.973,350,0.909,351,0.973,352,0.973,353,0.973,354,0.973,355,0.973,356,0.734,357,0.973,358,0.973,359,0.973,360,0.855,361,0.973,362,0.909,363,0.973,364,0.973,365,0.973,366,0.855,367,0.973,368,0.909,369,0.81,370,0.973,371,2.436,376,1.504,405,1.087,410,0.855,412,0.77,433,0.973,478,0.673,479,1.053,510,1.053,516,1.494,526,0.973,546,1.699,590,1.053,656,2.448,657,1.16,658,1.16,659,1.16,660,1.16,661,1.16,662,1.16,663,1.16,664,1.16,665,1.587,666,2.026,667,1.839,668,2.026,669,2.026,670,2.707,671,3.234,672,1.16,673,1.16,674,1.16,675,1.16,676,1.16,677,1.16,678,1.16,679,1.16,680,1.16,681,1.16,682,1.16,683,0.909,684,1.16,685,1.16,686,1.16,687,1.16,688,4.568,689,2.026,690,1.16,691,1.16,692,1.839,693,1.16,694,1.16,695,2.026,696,1.16,697,1.16,698,2.026,699,1.16,700,1.053,701,2.026,702,1.16,703,1.16,704,1.16,705,1.16,706,1.16,707,1.053,708,1.053,709,2.026,710,2.026,711,2.026,712,1.16,713,1.16,714,1.16,715,1.839]],["title/28",[9,1.172,10,0.571,11,1.616,74,0.881,152,1.7]],["description/28",[5,4.732,10,1.222,14,3.46,74,1.885,152,3.64,196,3.64,546,4.372,656,4.732,657,5.215,658,5.215,659,5.215,660,5.215,661,5.215,662,5.215]],["title/29",[376,2.629]],["description/29",[6,1.871,10,0.693,14,1.961,19,1.607,27,2.682,33,2.478,35,2.478,36,2.557,74,2.252,87,3.619,105,2.478,161,2.682,165,2.542,180,1.374,205,3.917,220,3.228,227,3.013,371,1.961,376,1.648,478,1.715,663,2.955,664,2.955,665,3.381,666,4.316,667,3.917,668,4.316,669,4.316,670,4.398,671,5.608,672,2.955,673,2.955,674,2.955,675,2.955,676,2.955,677,2.955,678,2.955,679,2.955,680,2.955,681,2.955,682,2.955,683,2.315,684,2.955,685,2.955,686,2.955,687,2.955]],["title/30",[8,1.777,688,3.468]],["description/30",[7,2.076,8,2.778,10,1.446,15,1.653,19,1.554,29,1.653,31,1.653,36,2.072,58,1.746,60,1.499,68,3.317,74,1.961,79,1.499,106,1.986,112,1.434,136,1.499,137,1.855,138,4.547,142,2.314,143,3.317,150,1.271,151,1.181,152,1.653,153,2.15,172,0.362,180,1.102,196,1.653,211,1.572,220,1.499,258,1.855,310,1.031,342,1.271,371,3.33,376,1.321,405,1.961,410,1.746,412,1.572,433,1.986,510,2.15,516,1.746,546,1.986,590,2.15,656,3.317,688,5.744,689,3.655,690,2.369,691,2.369,692,2.15,693,2.369,694,2.369,695,3.655,696,2.369,697,2.369,698,3.655,699,2.369,700,2.15,701,3.655,702,2.369,703,2.369,704,2.369,705,2.369,706,2.369,707,2.15,708,2.15,709,3.655,710,3.655,711,3.655,712,2.369,713,2.369]],["title/31",[74,1.705]],["description/31",[10,1.33,14,2.918,15,3.07,19,1.627,36,2.273,74,2.052,127,2.452,152,3.962,172,0.672,196,3.07,197,2.918,209,3.962,210,3.593,217,3.687,306,3.991,342,2.359,479,3.991,516,3.243,526,3.687,692,3.991,714,4.398,715,5.151]],["title/32",[]],["description/32",[]],["title/33",[716,5.377]],["description/33",[10,1.355,34,2.689,172,1.026,180,2.689]],["title/34",[717,5.377]],["description/34",[77,4.316,172,1.033,193,3.706]],["title/35",[718,5.377]],["description/35",[104,4.137,172,0.905,719,5.378]],["title/36",[720,5.377]],["description/36",[172,0.894,303,3.264,310,2.548,719,5.312]],["title/37",[721,5.377]],["description/37",[17,2.841,156,1.251,172,1.009,198,1.251,251,2.13,272,1.251,305,1.363,310,2.13,360,3.608,405,2.625,412,3.247,416,4.894,608,3.608,708,4.441,719,4.441,722,5.512,723,4.894]],["title/38",[724,5.377]],["description/38",[34,2.689,156,1.716,172,0.883,404,4.53]],["title/39",[725,4.715]],["description/39",[156,1.74,181,2.756]],["title/40",[726,5.377]],["description/40",[104,4.137,156,1.514,727,5.378]],["title/41",[728,5.377]],["description/41",[156,1.496,303,3.264,310,2.548,727,5.312]],["title/42",[729,5.377]],["description/42",[10,1.372,156,1.496,478,3.398,727,5.312]],["title/43",[730,5.377]],["description/43",[84,3.343,150,3.609,193,3.23,244,4.135,569,3.562,725,5.103,731,5.82,732,5.82,733,5.82,734,5.82,735,5.82,736,5.82]],["title/44",[737,5.377]],["description/44",[34,2.689,156,1.478,198,1.478,230,3.502,738,5.783]],["title/45",[739,5.377]],["description/45",[77,4.316,156,1.496,198,1.496,738,5.854]],["title/46",[740,5.377]],["description/46",[156,1.478,172,0.883,198,1.478,478,3.357,741,6.595]],["title/47",[742,5.377]],["description/47",[34,2.722,156,1.496,198,1.496,236,5.312]],["title/48",[743,5.377]],["description/48",[156,1.496,181,2.722,198,1.496,236,5.312]],["title/49",[744,5.377]],["description/49",[104,4.086,156,1.496,198,1.496,745,5.312]],["title/50",[746,5.377]],["description/50",[303,3.264,310,2.548,327,5.312,745,5.312]],["title/51",[747,5.377]],["description/51",[10,1.355,156,1.478,198,1.478,478,3.357,745,5.248]],["title/52",[748,5.377]],["description/52",[34,2.626,156,1.692,198,1.443,230,3.419,749,5.646,750,6.439]],["title/53",[751,5.377]],["description/53",[156,1.46,172,0.873,198,1.704,407,4.213,752,5.714]],["title/54",[753,5.377]],["description/54",[156,1.46,172,0.873,198,1.704,230,3.46,752,5.714]],["title/55",[754,5.377]],["description/55",[156,1.46,172,0.873,198,1.704,478,3.317,755,6.516]],["title/56",[756,5.377]],["description/56",[34,2.689,172,0.883,198,1.478,310,2.517,757,5.783]],["title/57",[758,5.377]],["description/57",[172,0.883,181,2.689,193,3.661,198,1.478,757,5.783]],["title/58",[759,5.377]],["description/58",[104,4.086,198,1.496,310,2.548,760,5.312]],["title/59",[761,5.377]],["description/59",[172,0.883,198,1.478,303,3.224,310,2.517,760,5.248]],["title/60",[762,5.377]],["description/60",[172,0.852,198,1.426,251,2.429,310,2.429,384,3.703,722,5.967,760,5.064]],["title/61",[763,5.377]],["description/61",[34,2.626,172,0.863,198,1.443,230,3.419,327,5.124,749,5.646,764,6.439]],["title/62",[765,5.377]],["description/62",[34,2.657,172,0.873,198,1.46,251,2.487,766,6.516,767,5.185]],["title/63",[768,5.377]],["description/63",[77,4.213,172,0.873,193,3.617,198,1.46,251,2.487,767,5.185]],["title/64",[769,5.377]],["description/64",[36,1.42,156,1.004,196,2.741,198,1.519,207,3.335,220,3.335,251,3.084,273,3.928,322,4.418,366,3.885,520,3.928,599,3.928,715,3.564,722,3.564,723,5.269,767,3.564,770,6.009,771,4.479,772,4.479,773,3.564,774,6.009,775,6.009,776,3.564,777,4.479,778,4.479,779,4.479,780,4.479]],["title/65",[74,1.382,84,2.05]],["description/65",[]],["title/66",[34,1.288,74,1.002,165,1.381,172,0.423]],["description/66",[16,3.882,18,1.313,19,1.598,29,2.037,36,2.016,64,2.649,74,2.552,81,4.846,83,1.767,136,3.205,142,1.848,165,3.194,172,0.907,194,2.447,195,1.848,196,4.143,197,1.937,255,2.649,297,2.649,415,2.447,449,2.649,521,2.919,630,4.143,781,2.649,782,3.329,783,3.329,784,4.878,785,5.06,786,3.329,787,3.329,788,3.329,789,3.329,790,3.329,791,3.329,792,3.329,793,3.329]],["title/67",[84,2.05,665,2.993]],["description/67",[]],["title/68",[19,0.794,665,2.17,670,2.043,794,2.77]],["description/68",[17,1.157,18,0.896,19,1.833,36,0.721,74,0.721,81,4.79,123,1.435,150,2.857,172,0.304,200,2.215,210,1.262,271,1.391,298,3.346,299,2.896,307,3.191,319,2.896,330,3.991,338,1.069,345,1.322,366,2.353,451,1.809,482,1.671,509,3.191,516,1.469,563,3.826,665,3.126,670,5.345,683,1.561,794,5.812,795,7.408,796,2.896,797,2.273,798,3.639,799,3.639,800,3.639,801,4.551,802,2.273,803,3.91,804,1.671,805,2.273,806,2.273,807,5.204,808,3.639,809,2.273,810,2.273,811,2.273,812,2.273,813,3.639,814,1.671,815,2.273,816,2.273]],["title/69",[84,2.05,172,0.584]],["description/69",[]],["title/70",[34,1.359,195,1.131,227,1.248,272,0.747,776,1.622,817,1.622]],["description/70",[1,2.859,19,1.553,34,2.52,174,3.434,195,2.593,227,2.859,244,3.596,272,1.8,305,1.141,310,1.783,527,3.717,570,2.197,591,3.717,776,4.917,818,4.671,819,6.18,820,6.925,821,6.18,822,4.671,823,6.18,824,4.671,825,4.671,826,4.671,827,4.096]],["title/71",[181,1.777,272,0.976]],["description/71",[77,3.931,136,3.375,165,2.657,181,2.479,211,3.538,227,3.721,272,1.362,614,5.331,630,4.467,827,5.331,828,6.08]],["title/72",[272,0.708,405,1.486,630,1.934,829,2.17]],["description/72",[142,3.574,244,3.747,272,1.443,405,3.029,570,3.029,630,3.941,830,5.124]],["title/73",[91,2.131,272,0.821,310,1.398]],["description/73",[91,3.747,112,3.419,272,1.443,310,2.458,569,3.941,830,5.124,831,4.734]],["title/74",[172,0.372,272,0.954,608,1.796,832,2.777]],["description/74",[830,5.515]],["title/75",[165,1.381,272,0.708,478,1.608,630,1.934]],["description/75",[6,2.863,34,2.103,82,2.739,136,2.863,165,2.254,194,3.792,220,2.863,272,1.477,303,2.522,318,3.543,356,2.863,371,3.001,407,3.335,449,4.105,478,3.697,533,4.523,630,4.685,803,4.527,831,3.792,833,5.158,834,5.158]],["title/76",[34,1.01,272,0.555,305,0.605,570,1.165,817,1.972,835,1.602]],["description/76",[179,3.617,244,3.792,272,1.46,305,1.591,835,4.213,836,5.714]],["title/77",[181,1.288,272,0.708,305,0.771,570,1.486]],["description/77",[1,2.44,17,2.029,19,1.002,40,2.578,81,3.588,159,4.416,165,1.743,180,1.626,181,3.143,242,3.496,244,3.229,305,1.919,405,2.61,411,3.173,412,2.32,532,3.496,707,3.173,773,3.173,781,3.173,796,3.173,804,2.931,814,2.931,836,3.496,837,6.052,838,3.987,839,4.866,840,3.987,841,3.987,842,4.74,843,3.987,844,5.08,845,3.496,846,3.496]],["title/78",[19,0.47,197,1.089,272,0.42,305,0.457,342,0.881,405,0.881,430,1.146,570,1.461]],["description/78",[19,1.599,197,3.703,305,1.554,342,2.993,405,2.993,430,3.895,570,2.993,847,6.364]],["title/79",[172,0.491,305,0.894,829,2.516]],["description/79",[6,2.945,18,2.093,19,1.849,74,2.452,112,3.274,150,1.759,172,0.826,200,1.299,210,2.076,226,2.418,305,1.848,342,1.759,345,2.177,371,2.177,405,2.901,409,3.28,440,2.977,569,3.248,647,2.977,670,4.581,683,2.569,785,2.977,803,3.644,804,2.75,829,2.569,844,2.977,848,3.28,849,3.741,850,3.28,851,4.653,852,3.28,853,3.28,854,3.28,855,3.28,856,2.75]],["title/80",[303,1.791,305,0.894,842,2.516]],["description/80",[1,2.184,17,2.612,18,2.024,19,1.289,29,2.184,59,4.499,77,2.307,91,2.077,129,3.129,159,2.84,165,2.243,181,2.092,193,2.848,298,3.772,303,2.937,305,1.769,318,2.451,356,3.335,404,2.451,405,1.679,408,2.184,415,2.624,527,2.84,544,2.451,667,2.84,773,2.84,781,2.84,837,4.499,839,3.129,842,4.78,844,4.781,845,3.129,846,3.129,856,2.624,857,3.569,858,5.131,859,3.569,860,3.569,861,3.569,862,6.569,863,5.131,864,3.569,865,3.569,866,3.569,867,3.569,868,3.569]],["title/81",[172,0.491,305,0.894,608,2.368]],["description/81",[172,0.894,305,1.63,478,3.398,856,4.908]],["title/82",[91,2.131,305,0.894,310,1.398]],["description/82",[91,3.618,112,3.302,270,3.452,272,1.393,305,1.518,310,2.374,569,3.806,570,2.925,831,4.572,856,4.572]],["title/83",[193,1.375,305,0.605,404,1.702,408,2.385,869,1.822]],["description/83",[82,3.123,136,3.265,272,1.318,305,1.747,338,2.767,356,3.265,371,3.423,418,4.681,544,4.04,835,3.803,869,4.325,870,5.158,871,5.158,872,5.883]],["title/84",[101,1.822,700,1.972,796,1.972,814,1.822,873,2.478,874,2.478]],["description/84",[875,6.931]],["title/85",[305,0.894,814,2.693,876,3.663]],["description/85",[877,6.931]],["title/86",[72,1.517,303,1.211,305,0.605,411,1.972,412,1.442,842,1.702]],["description/86",[878,6.931]],["title/87",[34,1.01,272,0.555,559,0.946,570,1.165,817,1.972,835,1.602]],["description/87",[179,3.617,244,3.792,272,1.46,559,2.487,835,4.213,879,5.714]],["title/88",[181,1.288,272,0.708,559,1.206,570,1.486]],["description/88",[181,2.689,272,1.478,559,2.517,570,3.102,879,5.783]],["title/89",[172,0.491,559,1.398,829,2.516]],["description/89",[6,3.049,18,1.55,19,1.813,74,2.434,112,3.363,150,1.848,172,0.848,200,1.364,210,2.181,226,2.541,342,1.848,345,2.286,405,2.979,440,3.127,559,2.854,569,3.362,647,3.127,670,4.666,683,2.699,785,3.127,803,3.773,804,2.889,829,2.699,848,3.446,850,3.446,851,4.817,852,3.446,853,3.446,854,3.446,855,3.446,880,3.93,881,2.889]],["title/90",[297,3.468,559,1.663]],["description/90",[303,3.264,559,2.548,842,4.585,881,4.908]],["title/91",[172,0.491,559,1.398,608,2.368]],["description/91",[172,0.894,478,3.398,559,2.548,881,4.908]],["title/92",[91,2.131,310,1.398,559,1.398]],["description/92",[91,3.577,244,3.577,270,3.413,272,1.378,310,2.347,559,2.347,569,3.763,570,2.892,803,4.223,831,4.52,881,4.52]],["title/93",[193,1.375,404,1.702,408,2.385,559,0.946,869,1.822]],["description/93",[82,3.123,136,3.265,272,1.318,338,2.767,356,3.265,371,3.423,418,4.681,544,4.04,559,2.731,835,3.803,869,4.325,870,5.158,871,5.158,882,5.883]]],"invertedIndex":[["",{"_index":36,"title":{"5":{}},"description":{"1":{},"2":{},"3":{},"4":{},"5":{},"6":{},"7":{},"9":{},"11":{},"12":{},"19":{},"20":{},"21":{},"22":{},"23":{},"25":{},"26":{},"27":{},"29":{},"30":{},"31":{},"64":{},"66":{},"68":{}}}],["1",{"_index":319,"title":{},"description":{"5":{},"8":{},"68":{}}}],["2",{"_index":509,"title":{},"description":{"8":{},"68":{}}}],["2.0",{"_index":349,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["21",{"_index":69,"title":{},"description":{"1":{}}}],["3",{"_index":798,"title":{},"description":{"68":{}}}],["3.5](https://spark.apache.org/releases/spark-release-3-5-0.html",{"_index":94,"title":{},"description":{"1":{},"5":{}}}],["6",{"_index":328,"title":{},"description":{"5":{}}}],["7",{"_index":329,"title":{},"description":{"5":{}}}],["8693",{"_index":854,"title":{},"description":{"79":{},"89":{}}}],["_databases_",{"_index":553,"title":{},"description":{"13":{}}}],["_note",{"_index":283,"title":{},"description":{"5":{}}}],["_schemas_",{"_index":552,"title":{},"description":{"13":{}}}],["_storag",{"_index":542,"title":{},"description":{"12":{}}}],["a.b.c.d.e.f.g",{"_index":554,"title":{},"description":{"13":{}}}],["abil",{"_index":260,"title":{},"description":{"4":{},"5":{},"25":{}}}],["abov",{"_index":105,"title":{},"description":{"2":{},"5":{},"27":{},"29":{}}}],["above](#building-and-deploying-polari",{"_index":90,"title":{},"description":{"1":{}}}],["above](#defining-a-catalog",{"_index":234,"title":{},"description":{"4":{}}}],["access",{"_index":200,"title":{"9":{},"20":{},"25":{}},"description":{"4":{},"5":{},"6":{},"7":{},"9":{},"12":{},"16":{},"17":{},"18":{},"19":{},"20":{},"21":{},"23":{},"24":{},"25":{},"26":{},"68":{},"79":{},"89":{}}}],["account",{"_index":820,"title":{},"description":{"70":{}}}],["accounting.tax",{"_index":824,"title":{},"description":{"70":{}}}],["accounting.tax.paid.info",{"_index":818,"title":{},"description":{"70":{}}}],["action",{"_index":508,"title":{},"description":{"8":{},"23":{}}}],["activ",{"_index":326,"title":{},"description":{"5":{}}}],["actor",{"_index":809,"title":{},"description":{"68":{}}}],["add",{"_index":77,"title":{},"description":{"1":{},"34":{},"45":{},"63":{},"71":{},"80":{}}}],["addgranttocatalogrol",{"_index":768,"title":{"63":{}},"description":{}}],["addit",{"_index":345,"title":{},"description":{"6":{},"7":{},"11":{},"20":{},"27":{},"68":{},"79":{},"89":{}}}],["addition",{"_index":217,"title":{},"description":{"4":{},"12":{},"27":{},"31":{}}}],["addschemaupd",{"_index":845,"title":{},"description":{"77":{},"80":{}}}],["adjust",{"_index":479,"title":{},"description":{"7":{},"27":{},"31":{}}}],["admin",{"_index":134,"title":{},"description":{"2":{},"26":{}}}],["administr",{"_index":467,"title":{},"description":{"7":{},"20":{},"22":{},"23":{},"24":{},"26":{}}}],["affect",{"_index":780,"title":{},"description":{"64":{}}}],["afterward",{"_index":712,"title":{},"description":{"27":{},"30":{}}}],["agre",{"_index":358,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["agreement",{"_index":340,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["ai",{"_index":464,"title":{},"description":{"7":{},"22":{},"26":{}}}],["alic",{"_index":506,"title":{},"description":{"8":{},"26":{}}}],["allow",{"_index":516,"title":{},"description":{"9":{},"23":{},"27":{},"30":{},"31":{},"68":{}}}],["alter",{"_index":607,"title":{},"description":{"23":{}}}],["amazon",{"_index":490,"title":{},"description":{"7":{}}}],["analog",{"_index":525,"title":{},"description":{"9":{}}}],["and/or",{"_index":533,"title":{},"description":{"10":{},"75":{}}}],["anoth",{"_index":418,"title":{},"description":{"7":{},"83":{},"93":{}}}],["apach",{"_index":9,"title":{"28":{}},"description":{"0":{},"1":{},"5":{},"6":{},"7":{},"8":{},"10":{},"11":{},"12":{},"14":{},"15":{},"20":{},"24":{},"26":{},"27":{}}}],["apache&reg",{"_index":529,"title":{},"description":{"10":{}}}],["api",{"_index":84,"title":{"65":{},"67":{},"69":{}},"description":{"1":{},"5":{},"12":{},"13":{},"14":{},"15":{},"16":{},"17":{},"19":{},"43":{}}}],["appear",{"_index":432,"title":{},"description":{"7":{}}}],["appli",{"_index":784,"title":{},"description":{"66":{}}}],["applic",{"_index":133,"title":{},"description":{"2":{},"6":{},"11":{},"20":{},"27":{}}}],["appropri",{"_index":279,"title":{},"description":{"5":{}}}],["architectur",{"_index":400,"title":{},"description":{"7":{}}}],["arctic",{"_index":422,"title":{},"description":{"7":{}}}],["arn",{"_index":215,"title":{},"description":{"4":{}}}],["arn</li><li>extern",{"_index":495,"title":{},"description":{"7":{}}}],["arn](https://docs.aws.amazon.com/iam/latest/userguide/reference-arns.html",{"_index":199,"title":{},"description":{"4":{}}}],["asf",{"_index":337,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["asid",{"_index":733,"title":{},"description":{"43":{}}}],["assert",{"_index":858,"title":{},"description":{"80":{}}}],["assert-cr",{"_index":867,"title":{},"description":{"80":{}}}],["assert-ref-snapshot-id",{"_index":860,"title":{},"description":{"80":{}}}],["assign",{"_index":230,"title":{},"description":{"4":{},"16":{},"17":{},"18":{},"20":{},"24":{},"44":{},"52":{},"54":{},"61":{}}}],["assigncatalogroletoprincipalrol",{"_index":753,"title":{"54":{}},"description":{}}],["assignprincipalrol",{"_index":739,"title":{"45":{}},"description":{}}],["associ",{"_index":384,"title":{},"description":{"7":{},"12":{},"13":{},"14":{},"15":{},"16":{},"17":{},"60":{}}}],["assum",{"_index":276,"title":{},"description":{"5":{}}}],["asymmetric](https://github.com/apache/polaris/blob/b482617bf8cc508b37dbedf3ebc81a9408160a5e/polaris-service/src/main/java/io/polaris/service/auth/jwtrsakeypair.java#l24",{"_index":677,"title":{},"description":{"27":{},"29":{}}}],["atom",{"_index":411,"title":{"86":{}},"description":{"7":{},"77":{}}}],["attempt",{"_index":859,"title":{},"description":{"80":{}}}],["authent",{"_index":205,"title":{},"description":{"4":{},"27":{},"29":{}}}],["authenticator.tokenbrok",{"_index":679,"title":{},"description":{"27":{},"29":{}}}],["author",{"_index":330,"title":{},"description":{"5":{},"68":{}}}],["automat",{"_index":148,"title":{},"description":{"3":{}}}],["avail",{"_index":545,"title":{},"description":{"12":{},"25":{}}}],["azur",{"_index":212,"title":{},"description":{"4":{},"7":{},"12":{}}}],["b",{"_index":555,"title":{},"description":{"13":{}}}],["backend",{"_index":700,"title":{"84":{}},"description":{"27":{},"30":{}}}],["base",{"_index":492,"title":{},"description":{"7":{},"17":{},"18":{}}}],["bash",{"_index":709,"title":{},"description":{"27":{},"30":{}}}],["basi",{"_index":359,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["be",{"_index":262,"title":{},"description":{"4":{}}}],["bearer",{"_index":683,"title":{},"description":{"27":{},"29":{},"68":{},"79":{},"89":{}}}],["befor",{"_index":29,"title":{},"description":{"1":{},"2":{},"4":{},"27":{},"30":{},"66":{},"80":{}}}],["begin",{"_index":843,"title":{},"description":{"77":{}}}],["behavior",{"_index":779,"title":{},"description":{"64":{}}}],["belong",{"_index":429,"title":{},"description":{"7":{},"23":{}}}],["below",{"_index":87,"title":{},"description":{"1":{},"3":{},"27":{},"29":{}}}],["beneath",{"_index":676,"title":{},"description":{"27":{},"29":{}}}],["best",{"_index":659,"title":{},"description":{"27":{},"28":{}}}],["bestow",{"_index":480,"title":{},"description":{"7":{},"23":{}}}],["between",{"_index":488,"title":{},"description":{"7":{},"22":{},"23":{},"24":{}}}],["bi",{"_index":461,"title":{},"description":{"7":{}}}],["bigint",{"_index":315,"title":{},"description":{"5":{}}}],["bin/spark-shel",{"_index":285,"title":{},"description":{"5":{}}}],["bob",{"_index":504,"title":{},"description":{"8":{},"26":{}}}],["bodi",{"_index":831,"title":{},"description":{"73":{},"75":{},"82":{},"92":{}}}],["bootstrap",{"_index":138,"title":{"3":{}},"description":{"3":{},"27":{},"30":{}}}],["both",{"_index":647,"title":{},"description":{"26":{},"79":{},"89":{}}}],["br",{"_index":605,"title":{},"description":{"23":{}}}],["branch",{"_index":93,"title":{},"description":{"1":{},"5":{}}}],["branch-3.5",{"_index":97,"title":{},"description":{"1":{},"5":{}}}],["brew",{"_index":48,"title":{},"description":{"1":{}}}],["broker",{"_index":671,"title":{},"description":{"27":{},"29":{}}}],["bronz",{"_index":651,"title":{},"description":{"26":{}}}],["bucket</li></ul",{"_index":497,"title":{},"description":{"7":{}}}],["bucket</li><li>loc",{"_index":493,"title":{},"description":{"7":{}}}],["bucket</li><li>s3",{"_index":494,"title":{},"description":{"7":{}}}],["build",{"_index":13,"title":{},"description":{"0":{},"1":{},"2":{}}}],["built",{"_index":65,"title":{},"description":{"1":{},"6":{}}}],["call",{"_index":194,"title":{},"description":{"4":{},"9":{},"66":{},"75":{}}}],["callcontextresolv",{"_index":680,"title":{},"description":{"27":{},"29":{}}}],["callcontextresolver](https://github.com/apache/polaris/blob/8290019c10290a600e40b35ddb1e2f54bf99e120/polaris-service/src/main/java/io/polaris/service/context/callcontextresolver.java#l27",{"_index":686,"title":{},"description":{"27":{},"29":{}}}],["cascad",{"_index":723,"title":{},"description":{"37":{},"64":{}}}],["case",{"_index":273,"title":{},"description":{"4":{},"64":{}}}],["cask",{"_index":57,"title":{},"description":{"1":{}}}],["catalog",{"_index":172,"title":{"4":{},"12":{},"18":{},"23":{},"66":{},"69":{},"74":{},"79":{},"81":{},"89":{},"91":{}},"description":{"4":{},"5":{},"6":{},"7":{},"8":{},"9":{},"12":{},"16":{},"18":{},"19":{},"20":{},"21":{},"22":{},"23":{},"24":{},"25":{},"26":{},"27":{},"30":{},"31":{},"33":{},"34":{},"35":{},"36":{},"37":{},"38":{},"46":{},"53":{},"54":{},"55":{},"56":{},"57":{},"59":{},"60":{},"61":{},"62":{},"63":{},"66":{},"68":{},"79":{},"81":{},"89":{},"91":{}}}],["catalog'",{"_index":808,"title":{},"description":{"68":{}}}],["catalog-rol",{"_index":238,"title":{},"description":{"4":{},"5":{}}}],["catalog.<br",{"_index":604,"title":{},"description":{"23":{}}}],["catalog1",{"_index":390,"title":{},"description":{"7":{},"8":{}}}],["catalog2",{"_index":391,"title":{},"description":{"7":{}}}],["catalog3",{"_index":392,"title":{},"description":{"7":{}}}],["catalog](#catalog",{"_index":550,"title":{},"description":{"13":{}}}],["catalog](#defining-a-catalog",{"_index":115,"title":{},"description":{"2":{}}}],["catalog](./entities.md#catalog",{"_index":173,"title":{},"description":{"4":{}}}],["catalog](./img/quickstart/privilege-illustration-1.png",{"_index":257,"title":{},"description":{"4":{}}}],["catalog_manage_access",{"_index":639,"title":{},"description":{"25":{}}}],["catalog_manage_cont",{"_index":265,"title":{},"description":{"4":{},"5":{},"25":{}}}],["catalog_manage_metadata",{"_index":642,"title":{},"description":{"25":{}}}],["catalog_read_properti",{"_index":643,"title":{},"description":{"25":{}}}],["catalog_write_properti",{"_index":644,"title":{},"description":{"25":{}}}],["catalogs/{catalognam",{"_index":719,"title":{},"description":{"35":{},"36":{},"37":{}}}],["catalogs/{catalogname}/catalog-rol",{"_index":757,"title":{},"description":{"56":{},"57":{}}}],["catalogs/{catalogname}/catalog-roles/{catalogrolenam",{"_index":760,"title":{},"description":{"58":{},"59":{},"60":{}}}],["catalogs/{catalogname}/catalog-roles/{catalogrolename}/gr",{"_index":767,"title":{},"description":{"62":{},"63":{},"64":{}}}],["catalogs/{catalogname}/catalog-roles/{catalogrolename}/principal-rol",{"_index":764,"title":{},"description":{"61":{}}}],["catalogs](#catalog",{"_index":572,"title":{},"description":{"18":{}}}],["catalogs](https://iceberg.apache.org/concepts/catalog",{"_index":540,"title":{},"description":{"12":{}}}],["cd",{"_index":50,"title":{},"description":{"1":{},"2":{},"4":{}}}],["central",{"_index":375,"title":{},"description":{"6":{},"9":{}}}],["certain",{"_index":527,"title":{},"description":{"9":{},"70":{},"80":{}}}],["chang",{"_index":844,"title":{},"description":{"77":{},"79":{},"80":{}}}],["check",{"_index":91,"title":{"73":{},"82":{},"92":{}},"description":{"1":{},"73":{},"80":{},"82":{},"92":{}}}],["checkout",{"_index":96,"title":{},"description":{"1":{}}}],["child",{"_index":865,"title":{},"description":{"80":{}}}],["claim",{"_index":799,"title":{},"description":{"68":{}}}],["class",{"_index":581,"title":{},"description":{"19":{}}}],["cli",{"_index":168,"title":{},"description":{"3":{},"4":{},"5":{}}}],["client",{"_index":81,"title":{},"description":{"1":{},"5":{},"7":{},"66":{},"68":{},"77":{}}}],["client-id",{"_index":182,"title":{},"description":{"4":{},"5":{}}}],["client-id>:<client-secret",{"_index":163,"title":{},"description":{"3":{}}}],["client-secret",{"_index":184,"title":{},"description":{"4":{},"5":{}}}],["client-specif",{"_index":789,"title":{},"description":{"66":{}}}],["client_id",{"_index":183,"title":{},"description":{"4":{},"5":{}}}],["client_id=<client-id",{"_index":170,"title":{},"description":{"3":{}}}],["client_secret",{"_index":185,"title":{},"description":{"4":{},"5":{}}}],["client_secret=<client-secret",{"_index":171,"title":{},"description":{"3":{}}}],["clientid",{"_index":246,"title":{},"description":{"4":{}}}],["clientsecret",{"_index":248,"title":{},"description":{"4":{}}}],["clone",{"_index":41,"title":{},"description":{"1":{},"5":{}}}],["cloud",{"_index":397,"title":{},"description":{"7":{},"9":{}}}],["code",{"_index":38,"title":{},"description":{"1":{}}}],["command",{"_index":241,"title":{},"description":{"4":{},"5":{}}}],["command-lin",{"_index":26,"title":{},"description":{"1":{}}}],["commit",{"_index":842,"title":{"80":{},"86":{}},"description":{"77":{},"80":{},"90":{}}}],["common",{"_index":791,"title":{},"description":{"66":{}}}],["compat",{"_index":67,"title":{},"description":{"1":{}}}],["complet",{"_index":242,"title":{},"description":{"4":{},"77":{}}}],["complianc",{"_index":351,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["compos",{"_index":107,"title":{},"description":{"2":{}}}],["concept",{"_index":382,"title":{"7":{}},"description":{"7":{},"20":{}}}],["conceptu",{"_index":379,"title":{},"description":{"6":{}}}],["concurr",{"_index":868,"title":{},"description":{"80":{}}}],["condit",{"_index":362,"title":{},"description":{"6":{},"7":{},"11":{},"20":{},"27":{}}}],["conf",{"_index":287,"title":{},"description":{"5":{}}}],["configur",{"_index":74,"title":{"27":{},"28":{},"31":{},"65":{},"66":{}},"description":{"1":{},"3":{},"4":{},"5":{},"7":{},"9":{},"12":{},"22":{},"23":{},"25":{},"26":{},"27":{},"28":{},"29":{},"30":{},"31":{},"66":{},"68":{},"79":{},"89":{}}}],["connect",{"_index":79,"title":{},"description":{"1":{},"5":{},"7":{},"8":{},"9":{},"22":{},"26":{},"27":{},"30":{}}}],["consid",{"_index":692,"title":{},"description":{"27":{},"30":{},"31":{}}}],["consist",{"_index":521,"title":{},"description":{"9":{},"66":{}}}],["construct",{"_index":786,"title":{},"description":{"66":{}}}],["contain",{"_index":112,"title":{},"description":{"2":{},"7":{},"12":{},"13":{},"27":{},"30":{},"73":{},"79":{},"82":{},"89":{}}}],["container</li><li>azur",{"_index":500,"title":{},"description":{"7":{}}}],["container</li><li>loc",{"_index":499,"title":{},"description":{"7":{}}}],["content",{"_index":264,"title":{},"description":{"4":{},"25":{}}}],["context",{"_index":806,"title":{},"description":{"68":{}}}],["continu",{"_index":113,"title":{},"description":{"2":{}}}],["contributor",{"_index":339,"title":{},"description":{"6":{},"11":{},"20":{},"23":{},"26":{},"27":{}}}],["control",{"_index":470,"title":{"9":{},"20":{},"25":{}},"description":{"7":{},"9":{},"20":{},"25":{},"26":{}}}],["control](access-control.md",{"_index":473,"title":{},"description":{"7":{},"9":{}}}],["copi",{"_index":353,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["copyright",{"_index":347,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["correct",{"_index":221,"title":{},"description":{"4":{}}}],["correctli",{"_index":435,"title":{},"description":{"7":{}}}],["countri",{"_index":534,"title":{},"description":{"10":{}}}],["cover",{"_index":22,"title":{},"description":{"1":{}}}],["creat",{"_index":181,"title":{"71":{},"77":{},"88":{}},"description":{"4":{},"5":{},"7":{},"8":{},"23":{},"25":{},"26":{},"39":{},"48":{},"57":{},"71":{},"77":{},"80":{},"88":{}}}],["create/list/read/writ",{"_index":269,"title":{},"description":{"4":{}}}],["createcatalog",{"_index":717,"title":{"34":{}},"description":{}}],["createcatalogrol",{"_index":758,"title":{"57":{}},"description":{}}],["createprincip",{"_index":725,"title":{"39":{}},"description":{"43":{}}}],["createprincipalrol",{"_index":743,"title":{"48":{}},"description":{}}],["createt",{"_index":866,"title":{},"description":{"80":{}}}],["creation",{"_index":485,"title":{},"description":{"7":{}}}],["credenti",{"_index":150,"title":{},"description":{"3":{},"4":{},"5":{},"7":{},"9":{},"12":{},"25":{},"27":{},"30":{},"43":{},"68":{},"79":{},"89":{}}}],["credentials._",{"_index":284,"title":{},"description":{"5":{}}}],["cta",{"_index":838,"title":{},"description":{"77":{}}}],["current",{"_index":404,"title":{"83":{},"93":{}},"description":{"7":{},"38":{},"80":{}}}],["custom",{"_index":444,"title":{},"description":{"7":{}}}],["dashboard",{"_index":462,"title":{},"description":{"7":{}}}],["data",{"_index":203,"title":{},"description":{"4":{},"5":{},"7":{},"8":{},"9":{},"12":{},"13":{},"14":{},"15":{},"16":{},"17":{},"18":{},"22":{},"25":{},"26":{}}}],["data_engin",{"_index":593,"title":{},"description":{"22":{},"26":{}}}],["data_scientist",{"_index":594,"title":{},"description":{"22":{},"26":{}}}],["databas",{"_index":695,"title":{},"description":{"27":{},"30":{}}}],["default",{"_index":196,"title":{},"description":{"4":{},"27":{},"28":{},"30":{},"31":{},"64":{},"66":{}}}],["default-base-loc",{"_index":188,"title":{},"description":{"4":{}}}],["default-realm",{"_index":162,"title":{},"description":{"3":{}}}],["default_base_loc",{"_index":189,"title":{},"description":{"4":{}}}],["defaultpolarisauthent",{"_index":675,"title":{},"description":{"27":{},"29":{}}}],["defin",{"_index":114,"title":{"4":{}},"description":{"2":{},"3":{},"7":{}}}],["degre",{"_index":577,"title":{},"description":{"19":{}}}],["deleg",{"_index":524,"title":{},"description":{"9":{}}}],["delet",{"_index":722,"title":{},"description":{"37":{},"60":{},"64":{}}}],["deletecatalog",{"_index":721,"title":{"37":{}},"description":{}}],["deletecatalogrol",{"_index":762,"title":{"60":{}},"description":{}}],["deleteprincip",{"_index":729,"title":{"42":{}},"description":{}}],["deleteprincipalrol",{"_index":747,"title":{"51":{}},"description":{}}],["depend",{"_index":85,"title":{},"description":{"1":{},"5":{},"12":{}}}],["deploy",{"_index":14,"title":{"2":{}},"description":{"0":{},"1":{},"2":{},"27":{},"28":{},"29":{},"31":{}}}],["describ",{"_index":12,"title":{},"description":{"0":{},"9":{},"25":{}}}],["descript",{"_index":592,"title":{},"description":{"22":{},"23":{},"25":{}}}],["destroy",{"_index":145,"title":{},"description":{"3":{}}}],["detail",{"_index":104,"title":{},"description":{"2":{},"4":{},"12":{},"35":{},"40":{},"49":{},"58":{}}}],["develo",{"_index":658,"title":{},"description":{"27":{},"28":{}}}],["diagram",{"_index":380,"title":{},"description":{"6":{},"7":{},"8":{},"24":{},"26":{}}}],["differ",{"_index":214,"title":{},"description":{"4":{},"5":{},"6":{},"9":{},"12":{},"17":{}}}],["directli",{"_index":539,"title":{},"description":{"12":{},"22":{}}}],["directori",{"_index":437,"title":{},"description":{"7":{}}}],["disabl",{"_index":715,"title":{},"description":{"27":{},"31":{},"64":{}}}],["display",{"_index":450,"title":{},"description":{"7":{},"23":{}}}],["distribut",{"_index":343,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["doc",{"_index":582,"title":{},"description":{"19":{}}}],["docker",{"_index":52,"title":{},"description":{"1":{},"2":{}}}],["docker-compose.yml",{"_index":109,"title":{},"description":{"2":{}}}],["docker](https://www.docker.com",{"_index":24,"title":{},"description":{"1":{}}}],["docs](../regtests/client/python/docs/createcatalogrequest.md",{"_index":541,"title":{},"description":{"12":{}}}],["docs](../regtests/client/python/docs/createnamespacerequest.md",{"_index":556,"title":{},"description":{"13":{}}}],["docs](../regtests/client/python/docs/createprincipalrequest.md",{"_index":565,"title":{},"description":{"16":{}}}],["docs](../regtests/client/python/docs/createprincipalrolerequest.md",{"_index":571,"title":{},"description":{"17":{}}}],["docs](../regtests/client/python/docs/createtablerequest.md",{"_index":558,"title":{},"description":{"14":{}}}],["docs](../regtests/client/python/docs/createviewrequest.md",{"_index":561,"title":{},"description":{"15":{}}}],["docs](../regtests/client/python/docs/storageconfiginfo.md",{"_index":549,"title":{},"description":{"12":{}}}],["docs](./command-line-interface.md",{"_index":229,"title":{},"description":{"4":{}}}],["docs](./configuring-polaris-for-production.md",{"_index":154,"title":{},"description":{"3":{}}}],["docs](./entities.md#storage-typ",{"_index":216,"title":{},"description":{"4":{}}}],["document",{"_index":255,"title":{},"description":{"4":{},"11":{},"66":{}}}],["documentation](https://iceberg.apache.org/concepts/catalog",{"_index":414,"title":{},"description":{"7":{}}}],["doesn't",{"_index":475,"title":{},"description":{"7":{}}}],["don't",{"_index":589,"title":{},"description":{"22":{}}}],["done",{"_index":56,"title":{},"description":{"1":{}}}],["down",{"_index":147,"title":{},"description":{"3":{},"4":{}}}],["dremio",{"_index":421,"title":{},"description":{"7":{}}}],["drop",{"_index":608,"title":{"74":{},"81":{},"91":{}},"description":{"23":{},"25":{},"37":{}}}],["durabl",{"_index":697,"title":{},"description":{"27":{},"30":{}}}],["dure",{"_index":484,"title":{},"description":{"7":{},"9":{}}}],["each",{"_index":447,"title":{},"description":{"7":{},"12":{},"16":{},"17":{},"18":{},"19":{},"24":{}}}],["eclipse-link",{"_index":693,"title":{},"description":{"27":{},"30":{}}}],["eclipselink",{"_index":701,"title":{},"description":{"27":{},"30":{}}}],["eclipselink](https://eclipse.dev/eclipselink",{"_index":702,"title":{},"description":{"27":{},"30":{}}}],["effect",{"_index":599,"title":{},"description":{"23":{},"64":{}}}],["elsewher",{"_index":302,"title":{},"description":{"5":{}}}],["empti",{"_index":832,"title":{"74":{}},"description":{}}],["emul",{"_index":603,"title":{},"description":{"23":{}}}],["enabl",{"_index":398,"title":{},"description":{"7":{},"25":{}}}],["encapsul",{"_index":448,"title":{},"description":{"7":{}}}],["encompass",{"_index":640,"title":{},"description":{"25":{}}}],["endpoint",{"_index":796,"title":{"84":{}},"description":{"68":{},"77":{}}}],["enforc",{"_index":434,"title":{},"description":{"7":{},"9":{}}}],["engin",{"_index":204,"title":{},"description":{"4":{},"5":{},"6":{},"7":{},"9":{},"22":{},"26":{}}}],["ensur",{"_index":667,"title":{},"description":{"27":{},"29":{},"80":{}}}],["entiti",{"_index":7,"title":{"11":{}},"description":{"0":{},"3":{},"4":{},"7":{},"9":{},"11":{},"12":{},"13":{},"14":{},"15":{},"16":{},"17":{},"18":{},"19":{},"27":{},"30":{}}}],["environ",{"_index":166,"title":{},"description":{"3":{}}}],["etc",{"_index":614,"title":{},"description":{"25":{},"71":{}}}],["etl",{"_index":456,"title":{},"description":{"7":{}}}],["eventu",{"_index":121,"title":{},"description":{"2":{}}}],["everyth",{"_index":266,"title":{},"description":{"4":{}}}],["exampl",{"_index":18,"title":{"8":{},"26":{}},"description":{"0":{},"1":{},"3":{},"4":{},"7":{},"8":{},"13":{},"22":{},"23":{},"25":{},"26":{},"66":{},"68":{},"79":{},"80":{},"89":{}}}],["example](access-control.md#rbac-exampl",{"_index":481,"title":{},"description":{"7":{}}}],["except",{"_index":350,"title":{},"description":{"6":{},"11":{},"20":{},"25":{},"27":{}}}],["exchang",{"_index":795,"title":{},"description":{"68":{}}}],["execut",{"_index":515,"title":{},"description":{"9":{}}}],["exist",{"_index":310,"title":{"73":{},"82":{},"92":{}},"description":{"5":{},"7":{},"27":{},"30":{},"36":{},"37":{},"41":{},"50":{},"56":{},"58":{},"59":{},"60":{},"70":{},"73":{},"82":{},"92":{}}}],["expect",{"_index":864,"title":{},"description":{"80":{}}}],["expir",{"_index":801,"title":{},"description":{"68":{}}}],["export",{"_index":169,"title":{},"description":{"3":{}}}],["express",{"_index":364,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["extern",{"_index":275,"title":{},"description":{"5":{},"7":{},"9":{}}}],["f",{"_index":108,"title":{},"description":{"2":{}}}],["fals",{"_index":840,"title":{},"description":{"77":{}}}],["featureconfiguration.supported_catalog_storage_typ",{"_index":714,"title":{},"description":{"27":{},"31":{}}}],["few",{"_index":63,"title":{},"description":{"1":{}}}],["file",{"_index":342,"title":{"78":{}},"description":{"6":{},"7":{},"9":{},"11":{},"12":{},"20":{},"27":{},"30":{},"31":{},"78":{},"79":{},"89":{}}}],["file](https://eclipse.dev/eclipselink/documentation/2.5/solutions/testingjpa002.htm",{"_index":705,"title":{},"description":{"27":{},"30":{}}}],["fileio",{"_index":849,"title":{},"description":{"79":{}}}],["filesystem",{"_index":306,"title":{},"description":{"5":{},"27":{},"31":{}}}],["final",{"_index":16,"title":{},"description":{"0":{},"5":{},"66":{}}}],["find",{"_index":278,"title":{},"description":{"5":{}}}],["fine-grain",{"_index":612,"title":{},"description":{"25":{}}}],["first",{"_index":64,"title":{},"description":{"1":{},"7":{},"66":{}}}],["flag",{"_index":225,"title":{},"description":{"4":{}}}],["flink",{"_index":452,"title":{},"description":{"7":{}}}],["flink&reg",{"_index":454,"title":{},"description":{"7":{},"10":{}}}],["flow",{"_index":794,"title":{"68":{}},"description":{"68":{}}}],["follow",{"_index":127,"title":{},"description":{"2":{},"5":{},"7":{},"8":{},"21":{},"22":{},"23":{},"24":{},"25":{},"26":{},"27":{},"31":{}}}],["forbidden",{"_index":325,"title":{},"description":{"5":{}}}],["form",{"_index":399,"title":{},"description":{"7":{}}}],["found",{"_index":157,"title":{},"description":{"3":{}}}],["foundat",{"_index":336,"title":{},"description":{"6":{},"10":{},"11":{},"20":{},"27":{}}}],["full",{"_index":226,"title":{},"description":{"4":{},"23":{},"25":{},"26":{},"79":{},"89":{}}}],["fulli",{"_index":263,"title":{},"description":{"4":{}}}],["gc",{"_index":426,"title":{},"description":{"7":{},"12":{}}}],["gener",{"_index":300,"title":{},"description":{"5":{},"7":{}}}],["getcatalog",{"_index":718,"title":{"35":{}},"description":{}}],["getcatalogrol",{"_index":759,"title":{"58":{}},"description":{}}],["getprincip",{"_index":726,"title":{"40":{}},"description":{}}],["getprincipalrol",{"_index":744,"title":{"49":{}},"description":{}}],["git",{"_index":45,"title":{},"description":{"1":{}}}],["git](https://git-scm.com",{"_index":43,"title":{},"description":{"1":{}}}],["give",{"_index":259,"title":{},"description":{"4":{}}}],["given",{"_index":570,"title":{"76":{},"77":{},"78":{},"87":{},"88":{}},"description":{"17":{},"19":{},"70":{},"72":{},"78":{},"82":{},"88":{},"92":{}}}],["glue",{"_index":420,"title":{},"description":{"7":{}}}],["gold",{"_index":649,"title":{},"description":{"26":{}}}],["googl",{"_index":396,"title":{},"description":{"7":{}}}],["govern",{"_index":368,"title":{},"description":{"6":{},"9":{},"11":{},"20":{},"27":{}}}],["gradle](https://gradle.org",{"_index":66,"title":{},"description":{"1":{}}}],["gradlew",{"_index":116,"title":{},"description":{"2":{}}}],["grant",{"_index":251,"title":{},"description":{"4":{},"5":{},"7":{},"9":{},"17":{},"18":{},"19":{},"20":{},"21":{},"22":{},"23":{},"24":{},"25":{},"26":{},"37":{},"60":{},"62":{},"63":{},"64":{}}}],["group",{"_index":428,"title":{},"description":{"7":{},"18":{},"22":{}}}],["guid",{"_index":2,"title":{},"description":{"0":{},"1":{},"5":{}}}],["hadoop-aw",{"_index":304,"title":{},"description":{"5":{}}}],["handl",{"_index":805,"title":{},"description":{"68":{}}}],["header",{"_index":813,"title":{},"description":{"68":{}}}],["here",{"_index":35,"title":{},"description":{"1":{},"5":{},"27":{},"29":{}}}],["hierarchi",{"_index":439,"title":{},"description":{"7":{}}}],["hold",{"_index":766,"title":{},"description":{"62":{}}}],["homebrew](https://brew.sh",{"_index":46,"title":{},"description":{"1":{}}}],["host",{"_index":224,"title":{},"description":{"4":{}}}],["hostnam",{"_index":222,"title":{},"description":{"4":{}}}],["hour",{"_index":600,"title":{},"description":{"23":{}}}],["http",{"_index":782,"title":{},"description":{"66":{}}}],["http://www.apache.org/licenses/license-2.0",{"_index":354,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["https://github.com/apache/polaris.git",{"_index":51,"title":{},"description":{"1":{}}}],["https://github.com/apache/spark.git",{"_index":95,"title":{},"description":{"1":{}}}],["https://iceberg.apache.org/docs/latest/configuration/#catalog-properti",{"_index":792,"title":{},"description":{"66":{}}}],["i.",{"_index":685,"title":{},"description":{"27":{},"29":{}}}],["i.d.j.mutableservletcontexthandl",{"_index":131,"title":{},"description":{"2":{}}}],["iam",{"_index":483,"title":{},"description":{"7":{},"9":{}}}],["iceberg",{"_index":274,"title":{"5":{}},"description":{"5":{},"6":{},"7":{},"9":{},"12":{},"14":{},"15":{},"21":{}}}],["iceberg&trad",{"_index":372,"title":{},"description":{"6":{},"7":{},"8":{},"10":{}}}],["iceberg-spark",{"_index":280,"title":{},"description":{"5":{}}}],["iceberg](https://iceberg.apache.org",{"_index":80,"title":{},"description":{"1":{},"5":{}}}],["id",{"_index":298,"title":{},"description":{"5":{},"7":{},"68":{},"80":{}}}],["id</li></ul",{"_index":502,"title":{},"description":{"7":{}}}],["idempot",{"_index":735,"title":{},"description":{"43":{}}}],["ident",{"_index":482,"title":{},"description":{"7":{},"9":{},"16":{},"68":{}}}],["identifi",{"_index":835,"title":{"76":{},"87":{}},"description":{"76":{},"83":{},"87":{},"93":{}}}],["illustr",{"_index":610,"title":{},"description":{"24":{},"26":{}}}],["imag",{"_index":99,"title":{},"description":{"2":{}}}],["immedi",{"_index":841,"title":{},"description":{"77":{}}}],["implement",{"_index":371,"title":{},"description":{"6":{},"27":{},"29":{},"30":{},"75":{},"79":{},"83":{},"93":{}}}],["impli",{"_index":365,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["import",{"_index":433,"title":{},"description":{"7":{},"25":{},"27":{},"30":{}}}],["in-memori",{"_index":143,"title":{},"description":{"3":{},"27":{},"30":{}}}],["includ",{"_index":17,"title":{},"description":{"0":{},"5":{},"7":{},"12":{},"19":{},"25":{},"26":{},"37":{},"68":{},"77":{},"80":{}}}],["incub",{"_index":11,"title":{"28":{}},"description":{"0":{},"6":{},"7":{},"8":{},"11":{},"20":{},"27":{}}}],["incubating).](img/overview.svg",{"_index":381,"title":{},"description":{"6":{}}}],["incubating)](img/example-workflow.svg",{"_index":512,"title":{},"description":{"8":{}}}],["individu",{"_index":613,"title":{},"description":{"25":{}}}],["info",{"_index":128,"title":{},"description":{"2":{}}}],["inform",{"_index":151,"title":{},"description":{"3":{},"4":{},"6":{},"7":{},"9":{},"11":{},"12":{},"13":{},"14":{},"15":{},"16":{},"17":{},"20":{},"27":{},"30":{}}}],["ingest",{"_index":453,"title":{},"description":{"7":{}}}],["initi",{"_index":159,"title":{},"description":{"3":{},"77":{},"80":{}}}],["insert",{"_index":507,"title":{},"description":{"8":{}}}],["insid",{"_index":54,"title":{},"description":{"1":{},"12":{},"18":{},"19":{}}}],["instal",{"_index":44,"title":{},"description":{"1":{}}}],["instanc",{"_index":141,"title":{},"description":{"3":{}}}],["instead",{"_index":590,"title":{},"description":{"22":{},"27":{},"30":{}}}],["integr",{"_index":510,"title":{},"description":{"8":{},"27":{},"30":{}}}],["intend",{"_index":657,"title":{},"description":{"27":{},"28":{}}}],["interact",{"_index":25,"title":{},"description":{"1":{},"4":{},"9":{},"26":{}}}],["interfac",{"_index":27,"title":{},"description":{"1":{},"27":{},"29":{}}}],["intern",{"_index":416,"title":{},"description":{"7":{},"37":{}}}],["introduc",{"_index":383,"title":{},"description":{"7":{}}}],["introduct",{"_index":4,"title":{},"description":{"0":{}}}],["it'",{"_index":870,"title":{},"description":{"83":{},"93":{}}}],["item",{"_index":441,"title":{},"description":{"7":{}}}],["itself",{"_index":55,"title":{},"description":{"1":{},"3":{},"19":{}}}],["jar",{"_index":710,"title":{},"description":{"27":{},"30":{}}}],["java",{"_index":68,"title":{},"description":{"1":{},"27":{},"30":{}}}],["jenv",{"_index":75,"title":{},"description":{"1":{}}}],["jenv](https://www.jenv.b",{"_index":71,"title":{},"description":{"1":{}}}],["job",{"_index":458,"title":{},"description":{"7":{},"22":{}}}],["json",{"_index":850,"title":{},"description":{"79":{},"89":{}}}],["jwt",{"_index":811,"title":{},"description":{"68":{}}}],["keep",{"_index":661,"title":{},"description":{"27":{},"28":{}}}],["key",{"_index":6,"title":{"7":{}},"description":{"0":{},"7":{},"20":{},"27":{},"29":{},"75":{},"79":{},"89":{}}}],["key/valu",{"_index":783,"title":{},"description":{"66":{}}}],["kind",{"_index":363,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["label",{"_index":566,"title":{},"description":{"17":{},"18":{}}}],["languag",{"_index":367,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["last_modified_tim",{"_index":828,"title":{},"description":{"71":{}}}],["later",{"_index":245,"title":{},"description":{"4":{}}}],["latest",{"_index":37,"title":{},"description":{"1":{}}}],["launch",{"_index":106,"title":{},"description":{"2":{},"3":{},"27":{},"30":{}}}],["law",{"_index":357,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["layer",{"_index":401,"title":{},"description":{"7":{}}}],["learn",{"_index":413,"title":{},"description":{"7":{}}}],["legal",{"_index":528,"title":{"10":{}},"description":{}}],["let",{"_index":523,"title":{},"description":{"9":{}}}],["level",{"_index":591,"title":{},"description":{"22":{},"25":{},"70":{}}}],["licens",{"_index":334,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["lightweight",{"_index":98,"title":{},"description":{"2":{}}}],["likewis",{"_index":602,"title":{},"description":{"23":{}}}],["limit",{"_index":370,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["link",{"_index":254,"title":{},"description":{"4":{}}}],["list",{"_index":34,"title":{"66":{},"70":{},"76":{},"87":{}},"description":{"1":{},"19":{},"25":{},"33":{},"38":{},"44":{},"47":{},"52":{},"56":{},"61":{},"62":{},"70":{},"75":{}}}],["listassigneeprincipalrolesforcatalogrol",{"_index":763,"title":{"61":{}},"description":{}}],["listassigneeprincipalsforprincipalrol",{"_index":748,"title":{"52":{}},"description":{}}],["listcatalog",{"_index":716,"title":{"33":{}},"description":{}}],["listcatalogrol",{"_index":756,"title":{"56":{}},"description":{}}],["listcatalogrolesforprincipalrol",{"_index":751,"title":{"53":{}},"description":{}}],["listgrantsforcatalogrol",{"_index":765,"title":{"62":{}},"description":{}}],["listprincip",{"_index":724,"title":{"38":{}},"description":{}}],["listprincipalrol",{"_index":742,"title":{"47":{}},"description":{}}],["listprincipalrolesassign",{"_index":737,"title":{"44":{}},"description":{}}],["load",{"_index":829,"title":{"72":{},"79":{},"89":{}},"description":{"79":{},"89":{}}}],["load_table_with_read_deleg",{"_index":332,"title":{},"description":{"5":{}}}],["local",{"_index":15,"title":{},"description":{"0":{},"1":{},"2":{},"5":{},"27":{},"30":{},"31":{}}}],["localhost:8181",{"_index":219,"title":{},"description":{"4":{},"5":{}}}],["locat",{"_index":197,"title":{"78":{}},"description":{"4":{},"7":{},"9":{},"27":{},"31":{},"66":{},"78":{}}}],["log",{"_index":124,"title":{},"description":{"2":{}}}],["logic",{"_index":427,"title":{},"description":{"7":{},"13":{},"22":{}}}],["lose",{"_index":323,"title":{},"description":{"5":{}}}],["main",{"_index":129,"title":{},"description":{"2":{},"80":{}}}],["make",{"_index":59,"title":{},"description":{"1":{},"80":{}}}],["manag",{"_index":8,"title":{"30":{}},"description":{"0":{},"1":{},"4":{},"5":{},"7":{},"9":{},"11":{},"12":{},"13":{},"14":{},"15":{},"16":{},"17":{},"25":{},"27":{},"30":{}}}],["manger",{"_index":696,"title":{},"description":{"27":{},"30":{}}}],["manifest",{"_index":517,"title":{},"description":{"9":{}}}],["manner",{"_index":522,"title":{},"description":{"9":{}}}],["manual",{"_index":706,"title":{},"description":{"27":{},"30":{}}}],["many-to-mani",{"_index":601,"title":{},"description":{"23":{}}}],["many-to-on",{"_index":588,"title":{},"description":{"22":{},"24":{}}}],["map",{"_index":407,"title":{},"description":{"7":{},"12":{},"14":{},"15":{},"53":{},"75":{}}}],["mark",{"_index":653,"title":{},"description":{"26":{}}}],["match",{"_index":440,"title":{},"description":{"7":{},"79":{},"89":{}}}],["mean",{"_index":144,"title":{},"description":{"3":{},"23":{}}}],["meant",{"_index":690,"title":{},"description":{"27":{},"30":{}}}],["mechan",{"_index":575,"title":{},"description":{"18":{}}}],["messag",{"_index":125,"title":{},"description":{"2":{}}}],["met",{"_index":436,"title":{},"description":{"7":{}}}],["metadata",{"_index":405,"title":{"72":{},"78":{}},"description":{"7":{},"9":{},"27":{},"30":{},"37":{},"72":{},"77":{},"78":{},"79":{},"80":{},"89":{}}}],["metastor",{"_index":688,"title":{"30":{}},"description":{"27":{},"30":{}}}],["metastoremanag",{"_index":689,"title":{},"description":{"27":{},"30":{}}}],["metastoremanager.conf-fil",{"_index":703,"title":{},"description":{"27":{},"30":{}}}],["metastoremanager](https://github.com/apache/polaris/blob/627dc602eb15a3258dcc32babf8def34cf6de0e9/polaris-core/src/main/java/io/polaris/core/persistence/polarismetastoremanager.java#l47",{"_index":699,"title":{},"description":{"27":{},"30":{}}}],["metric",{"_index":873,"title":{"84":{}},"description":{}}],["microsoft",{"_index":498,"title":{},"description":{"7":{}}}],["mind",{"_index":662,"title":{},"description":{"27":{},"28":{}}}],["mode",{"_index":155,"title":{},"description":{"3":{}}}],["model",{"_index":472,"title":{"24":{}},"description":{"7":{},"9":{},"20":{},"24":{},"25":{}}}],["model](access-control.md#rbac-model",{"_index":474,"title":{},"description":{"7":{}}}],["modifi",{"_index":833,"title":{},"description":{"75":{}}}],["more",{"_index":123,"title":{},"description":{"2":{},"3":{},"4":{},"6":{},"7":{},"9":{},"11":{},"12":{},"13":{},"14":{},"15":{},"16":{},"17":{},"18":{},"20":{},"23":{},"27":{},"68":{}}}],["move",{"_index":871,"title":{},"description":{"83":{},"93":{}}}],["multipl",{"_index":72,"title":{"86":{}},"description":{"1":{},"7":{},"17":{},"18":{},"22":{},"23":{}}}],["name",{"_index":408,"title":{"83":{},"93":{}},"description":{"7":{},"8":{},"22":{},"26":{},"80":{}}}],["namespac",{"_index":272,"title":{"13":{},"70":{},"71":{},"72":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"87":{},"88":{}},"description":{"4":{},"5":{},"7":{},"8":{},"9":{},"13":{},"18":{},"19":{},"21":{},"23":{},"25":{},"26":{},"37":{},"70":{},"71":{},"72":{},"73":{},"75":{},"76":{},"82":{},"83":{},"87":{},"88":{},"92":{},"93":{}}}],["namespace1",{"_index":442,"title":{},"description":{"7":{},"8":{}}}],["namespace1/namespace1a/customers/<fil",{"_index":445,"title":{},"description":{"7":{}}}],["namespace1/namespace1a/orders/<fil",{"_index":446,"title":{},"description":{"7":{}}}],["namespace1a",{"_index":443,"title":{},"description":{"7":{}}}],["namespace_cr",{"_index":633,"title":{},"description":{"25":{}}}],["namespace_drop",{"_index":634,"title":{},"description":{"25":{}}}],["namespace_full_metadata",{"_index":638,"title":{},"description":{"25":{}}}],["namespace_list",{"_index":635,"title":{},"description":{"25":{}}}],["namespace_read_properti",{"_index":636,"title":{},"description":{"25":{}}}],["namespace_write_properti",{"_index":637,"title":{},"description":{"25":{}}}],["namespaces?parent=account",{"_index":822,"title":{},"description":{"70":{}}}],["namespaces?parent=accounting%1ftax",{"_index":825,"title":{},"description":{"70":{}}}],["namespaces](#namespac",{"_index":537,"title":{},"description":{"12":{}}}],["namespaces](overview.md#namespac",{"_index":388,"title":{},"description":{"7":{}}}],["natur",{"_index":573,"title":{},"description":{"18":{}}}],["necessari",{"_index":240,"title":{},"description":{"4":{}}}],["need",{"_index":40,"title":{},"description":{"1":{},"7":{},"17":{},"18":{},"25":{},"77":{}}}],["nest",{"_index":387,"title":{},"description":{"7":{},"13":{},"25":{}}}],["new",{"_index":193,"title":{"83":{},"93":{}},"description":{"4":{},"7":{},"34":{},"43":{},"57":{},"63":{},"80":{}}}],["non-empti",{"_index":848,"title":{},"description":{"79":{},"89":{}}}],["normal",{"_index":713,"title":{},"description":{"27":{},"30":{}}}],["notabl",{"_index":663,"title":{},"description":{"27":{},"29":{}}}],["note",{"_index":164,"title":{},"description":{"3":{},"4":{},"5":{},"23":{}}}],["notic",{"_index":341,"title":{"10":{}},"description":{"6":{},"11":{},"20":{},"27":{}}}],["notif",{"_index":876,"title":{"85":{}},"description":{}}],["now",{"_index":250,"title":{},"description":{"4":{},"5":{}}}],["o.e.j.s.handler.contexthandl",{"_index":130,"title":{},"description":{"2":{}}}],["o.e.j.server.abstractconnector",{"_index":132,"title":{},"description":{"2":{}}}],["o.eclipse.jetty.server.serv",{"_index":135,"title":{},"description":{"2":{}}}],["oauth2",{"_index":665,"title":{"67":{},"68":{}},"description":{"27":{},"29":{},"68":{}}}],["oauth](https://oauth.net/2",{"_index":672,"title":{},"description":{"27":{},"29":{}}}],["object",{"_index":175,"title":{"21":{}},"description":{"4":{},"7":{},"20":{},"21":{},"22":{},"23":{},"25":{}}}],["obtain",{"_index":352,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["on",{"_index":338,"title":{},"description":{"6":{},"7":{},"11":{},"16":{},"17":{},"18":{},"20":{},"22":{},"23":{},"27":{},"68":{},"83":{},"93":{}}}],["onc",{"_index":58,"title":{},"description":{"1":{},"2":{},"4":{},"5":{},"27":{},"30":{}}}],["op",{"_index":331,"title":{},"description":{"5":{}}}],["open",{"_index":373,"title":{},"description":{"6":{}}}],["openjdk@21",{"_index":76,"title":{},"description":{"1":{}}}],["oper",{"_index":412,"title":{"86":{}},"description":{"7":{},"23":{},"25":{},"27":{},"30":{},"37":{},"77":{}}}],["option",{"_index":227,"title":{"70":{}},"description":{"4":{},"25":{},"27":{},"29":{},"70":{},"71":{}}}],["optional)</li></ul",{"_index":496,"title":{},"description":{"7":{}}}],["order",{"_index":258,"title":{},"description":{"4":{},"7":{},"19":{},"27":{},"30":{}}}],["org.apache.iceberg.exceptions.forbiddenexcept",{"_index":324,"title":{},"description":{"5":{}}}],["org.apache.iceberg:iceberg-spark-runtime-3.5_2.12:1.5.2,org.apache.hadoop:hadoop-aws:3.4.0",{"_index":286,"title":{},"description":{"5":{}}}],["organ",{"_index":178,"title":{},"description":{"4":{},"7":{}}}],["otherwis",{"_index":852,"title":{},"description":{"79":{},"89":{}}}],["out",{"_index":92,"title":{},"description":{"1":{}}}],["outlin",{"_index":664,"title":{},"description":{"27":{},"29":{}}}],["output",{"_index":119,"title":{},"description":{"2":{}}}],["overrid",{"_index":785,"title":{},"description":{"66":{},"79":{},"89":{}}}],["overview",{"_index":333,"title":{"6":{}},"description":{"6":{}}}],["ownership",{"_index":348,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["packag",{"_index":281,"title":{},"description":{"5":{}}}],["page",{"_index":535,"title":{},"description":{"11":{}}}],["paid",{"_index":826,"title":{},"description":{"70":{}}}],["pair",{"_index":449,"title":{},"description":{"7":{},"66":{},"75":{}}}],["paramet",{"_index":772,"title":{},"description":{"64":{}}}],["parent",{"_index":776,"title":{"70":{}},"description":{"64":{},"70":{}}}],["part",{"_index":857,"title":{},"description":{"80":{}}}],["particular",{"_index":596,"title":{},"description":{"23":{}}}],["partit",{"_index":519,"title":{},"description":{"9":{}}}],["pass",{"_index":851,"title":{},"description":{"79":{},"89":{}}}],["path/to/jar/polaris-service-all.jar",{"_index":711,"title":{},"description":{"27":{},"30":{}}}],["perform",{"_index":410,"title":{},"description":{"7":{},"8":{},"23":{},"25":{},"27":{},"30":{}}}],["period",{"_index":802,"title":{},"description":{"68":{}}}],["permiss",{"_index":369,"title":{},"description":{"6":{},"11":{},"20":{},"22":{},"23":{},"26":{},"27":{}}}],["permit",{"_index":606,"title":{},"description":{"23":{}}}],["persist",{"_index":698,"title":{},"description":{"27":{},"30":{}}}],["persistence.xml",{"_index":704,"title":{},"description":{"27":{},"30":{}}}],["persona",{"_index":568,"title":{},"description":{"17":{}}}],["pipelin",{"_index":457,"title":{},"description":{"7":{}}}],["plan",{"_index":53,"title":{},"description":{"1":{}}}],["pleas",{"_index":228,"title":{},"description":{"4":{}}}],["point",{"_index":137,"title":{},"description":{"2":{},"5":{},"7":{},"27":{},"30":{}}}],["pointer",{"_index":406,"title":{},"description":{"7":{}}}],["polari",{"_index":10,"title":{"2":{},"3":{},"5":{},"11":{},"27":{},"28":{}},"description":{"0":{},"1":{},"2":{},"3":{},"4":{},"5":{},"6":{},"7":{},"8":{},"9":{},"11":{},"12":{},"13":{},"14":{},"15":{},"16":{},"17":{},"18":{},"19":{},"20":{},"21":{},"22":{},"23":{},"24":{},"25":{},"26":{},"27":{},"28":{},"29":{},"30":{},"31":{},"33":{},"42":{},"51":{}}}],["polaris-manag",{"_index":277,"title":{},"description":{"5":{}}}],["polaris-polari",{"_index":111,"title":{},"description":{"2":{}}}],["polaris-server.yml",{"_index":656,"title":{},"description":{"27":{},"28":{},"30":{}}}],["polaris.](img/rbac-example.svg",{"_index":655,"title":{},"description":{"26":{}}}],["polaris.](img/rbac-model.svg",{"_index":611,"title":{},"description":{"24":{}}}],["pool",{"_index":788,"title":{},"description":{"66":{}}}],["port",{"_index":223,"title":{},"description":{"4":{}}}],["power",{"_index":463,"title":{},"description":{"7":{}}}],["practic",{"_index":660,"title":{},"description":{"27":{},"28":{}}}],["prefix",{"_index":78,"title":{},"description":{"1":{}}}],["prepar",{"_index":707,"title":{},"description":{"27":{},"30":{},"77":{}}}],["prerequisit",{"_index":21,"title":{"1":{}},"description":{"1":{}}}],["prerequisites](#building-and-deploying-polari",{"_index":103,"title":{},"description":{"2":{}}}],["present",{"_index":777,"title":{},"description":{"64":{}}}],["princip",{"_index":156,"title":{"16":{},"17":{},"22":{}},"description":{"3":{},"4":{},"5":{},"7":{},"8":{},"9":{},"16":{},"17":{},"18":{},"19":{},"20":{},"22":{},"23":{},"24":{},"25":{},"26":{},"37":{},"38":{},"39":{},"40":{},"41":{},"42":{},"44":{},"45":{},"46":{},"47":{},"48":{},"49":{},"51":{},"52":{},"53":{},"54":{},"55":{},"64":{}}}],["principal'",{"_index":732,"title":{},"description":{"43":{}}}],["principal-rol",{"_index":236,"title":{},"description":{"4":{},"47":{},"48":{}}}],["principal-roles/{principalrolenam",{"_index":745,"title":{},"description":{"49":{},"50":{},"51":{}}}],["principal-roles/{principalrolename}/catalog-roles/{catalognam",{"_index":752,"title":{},"description":{"53":{},"54":{}}}],["principal-roles/{principalrolename}/catalog-roles/{catalogname}/{catalogrolenam",{"_index":755,"title":{},"description":{"55":{}}}],["principal-roles/{principalrolename}/princip",{"_index":750,"title":{},"description":{"52":{}}}],["principal](./entities.md#princip",{"_index":232,"title":{},"description":{"4":{}}}],["principalrol",{"_index":327,"title":{},"description":{"5":{},"50":{},"61":{}}}],["principals/{principalnam",{"_index":727,"title":{},"description":{"40":{},"41":{},"42":{}}}],["principals/{principalname}/principal-rol",{"_index":738,"title":{},"description":{"44":{},"45":{}}}],["principals/{principalname}/principal-roles/{principalrolenam",{"_index":741,"title":{},"description":{"46":{}}}],["principals/{principalname}/rot",{"_index":736,"title":{},"description":{"43":{}}}],["principals](#princip",{"_index":567,"title":{},"description":{"17":{}}}],["privileg",{"_index":231,"title":{"19":{},"25":{}},"description":{"4":{},"5":{},"7":{},"8":{},"9":{},"19":{},"20":{},"22":{},"23":{},"24":{},"25":{}}}],["privileges:<ul><li>catalog_manage_metadata</li><li>table_full_metadata</li><li>namespace_full_metadata</li><li>view_full_metadata</li><li>table_write_data</li><li>table_read_data</li><li>catalog_read_properties</li><li>catalog_write_properties</li></ul",{"_index":641,"title":{},"description":{"25":{}}}],["privileges](#privileg",{"_index":574,"title":{},"description":{"18":{}}}],["privileges](../regtests/client/python/docs/catalogprivilege.md",{"_index":586,"title":{},"description":{"19":{}}}],["privileges](../regtests/client/python/docs/namespaceprivilege.md",{"_index":585,"title":{},"description":{"19":{}}}],["privileges](../regtests/client/python/docs/tableprivilege.md",{"_index":583,"title":{},"description":{"19":{}}}],["privileges](../regtests/client/python/docs/viewprivilege.md",{"_index":584,"title":{},"description":{"19":{}}}],["privileges](./entities.md#privileg",{"_index":261,"title":{},"description":{"4":{}}}],["proceed",{"_index":30,"title":{},"description":{"1":{}}}],["process",{"_index":101,"title":{"84":{}},"description":{"2":{},"7":{},"9":{}}}],["product",{"_index":152,"title":{"27":{},"28":{}},"description":{"3":{},"27":{},"28":{},"30":{},"31":{}}}],["properti",{"_index":630,"title":{"72":{},"75":{}},"description":{"25":{},"66":{},"71":{},"72":{},"75":{}}}],["properties](https://iceberg.apache.org/docs/nightly/configuration/#table-properti",{"_index":619,"title":{},"description":{"25":{}}}],["protocol",{"_index":374,"title":{},"description":{"6":{}}}],["provid",{"_index":195,"title":{"70":{}},"description":{"4":{},"5":{},"6":{},"7":{},"12":{},"20":{},"66":{},"70":{}}}],["purg",{"_index":708,"title":{},"description":{"27":{},"30":{},"37":{}}}],["purpos",{"_index":451,"title":{},"description":{"7":{},"16":{},"68":{}}}],["queri",{"_index":378,"title":{},"description":{"6":{},"7":{},"9":{}}}],["quick",{"_index":0,"title":{"0":{}},"description":{}}],["quickstart_catalog",{"_index":192,"title":{},"description":{"4":{},"5":{}}}],["quickstart_catalog_rol",{"_index":239,"title":{},"description":{"4":{},"5":{}}}],["quickstart_namespac",{"_index":311,"title":{},"description":{"5":{}}}],["quickstart_namespace.schema",{"_index":312,"title":{},"description":{"5":{}}}],["quickstart_t",{"_index":314,"title":{},"description":{"5":{}}}],["quickstart_table\").show(fals",{"_index":321,"title":{},"description":{"5":{}}}],["quickstart_us",{"_index":235,"title":{},"description":{"4":{},"5":{}}}],["quickstart_user_rol",{"_index":237,"title":{},"description":{"4":{}}}],["rbac",{"_index":471,"title":{"24":{},"26":{}},"description":{"7":{},"9":{},"20":{},"24":{},"26":{}}}],["read",{"_index":201,"title":{},"description":{"4":{},"6":{},"7":{},"8":{},"23":{},"25":{}}}],["read+writ",{"_index":624,"title":{},"description":{"25":{}}}],["read-onli",{"_index":424,"title":{},"description":{"7":{},"23":{},"25":{},"26":{}}}],["reader",{"_index":609,"title":{},"description":{"23":{},"26":{}}}],["realm",{"_index":161,"title":{},"description":{"3":{},"27":{},"29":{}}}],["realmcontextresolv",{"_index":681,"title":{},"description":{"27":{},"29":{}}}],["realmcontextresolver](https://github.com/apache/polaris/blob/7ce86f10a68a3b56aed766235c88d6027c0de038/polaris-service/src/main/java/io/polaris/service/context/realmcontextresolver.java",{"_index":687,"title":{},"description":{"27":{},"29":{}}}],["receiv",{"_index":578,"title":{},"description":{"19":{},"25":{}}}],["recommend",{"_index":70,"title":{},"description":{"1":{}}}],["ref",{"_index":863,"title":{},"description":{"80":{}}}],["ref'",{"_index":861,"title":{},"description":{"80":{}}}],["refer",{"_index":86,"title":{},"description":{"1":{},"4":{},"13":{}}}],["reflect",{"_index":669,"title":{},"description":{"27":{},"29":{}}}],["refresh",{"_index":800,"title":{},"description":{"68":{}}}],["regard",{"_index":346,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["regist",{"_index":430,"title":{"78":{}},"description":{"7":{},"9":{},"10":{},"22":{},"25":{},"78":{}}}],["relat",{"_index":547,"title":{},"description":{"12":{}}}],["relationship",{"_index":487,"title":{},"description":{"7":{},"22":{},"23":{},"24":{}}}],["releas",{"_index":425,"title":{},"description":{"7":{}}}],["relev",{"_index":33,"title":{},"description":{"1":{},"2":{},"27":{},"29":{}}}],["remot",{"_index":694,"title":{},"description":{"27":{},"30":{}}}],["remov",{"_index":478,"title":{"75":{}},"description":{"7":{},"27":{},"29":{},"42":{},"46":{},"51":{},"55":{},"75":{},"81":{},"91":{}}}],["renam",{"_index":869,"title":{"83":{},"93":{}},"description":{"83":{},"93":{}}}],["replac",{"_index":297,"title":{"90":{}},"description":{"5":{},"66":{}}}],["repo",{"_index":49,"title":{},"description":{"1":{}}}],["report",{"_index":874,"title":{"84":{}},"description":{}}],["repositori",{"_index":42,"title":{},"description":{"1":{}}}],["repres",{"_index":466,"title":{},"description":{"7":{},"16":{}}}],["request",{"_index":803,"title":{},"description":{"68":{},"75":{},"79":{},"89":{},"92":{}}}],["request'",{"_index":815,"title":{},"description":{"68":{}}}],["requir",{"_index":356,"title":{},"description":{"6":{},"9":{},"11":{},"20":{},"27":{},"75":{},"80":{},"83":{},"93":{}}}],["resembl",{"_index":126,"title":{},"description":{"2":{}}}],["resid",{"_index":548,"title":{},"description":{"12":{},"13":{},"18":{}}}],["resolv",{"_index":682,"title":{},"description":{"27":{},"29":{}}}],["resourc",{"_index":207,"title":{},"description":{"4":{},"7":{},"9":{},"20":{},"22":{},"23":{},"24":{},"26":{},"64":{}}}],["respons",{"_index":569,"title":{},"description":{"17":{},"43":{},"73":{},"79":{},"82":{},"89":{},"92":{}}}],["rest",{"_index":83,"title":{},"description":{"1":{},"5":{},"6":{},"12":{},"13":{},"14":{},"15":{},"16":{},"17":{},"66":{}}}],["rest-compat",{"_index":377,"title":{},"description":{"6":{},"7":{}}}],["result",{"_index":476,"title":{},"description":{"7":{}}}],["retain",{"_index":520,"title":{},"description":{"9":{},"64":{}}}],["return",{"_index":244,"title":{},"description":{"4":{},"43":{},"70":{},"72":{},"76":{},"77":{},"87":{},"92":{}}}],["revoc",{"_index":774,"title":{},"description":{"64":{}}}],["revok",{"_index":322,"title":{},"description":{"5":{},"23":{},"25":{},"64":{}}}],["revokecatalogrolefromprincipalrol",{"_index":754,"title":{"55":{}},"description":{}}],["revokegrantfromcatalogrol",{"_index":769,"title":{"64":{}},"description":{}}],["revokeprincipalrol",{"_index":740,"title":{"46":{}},"description":{}}],["rfc",{"_index":853,"title":{},"description":{"79":{},"89":{}}}],["right",{"_index":652,"title":{},"description":{"26":{}}}],["role",{"_index":198,"title":{"17":{},"18":{},"22":{},"23":{}},"description":{"4":{},"7":{},"9":{},"17":{},"18":{},"19":{},"20":{},"22":{},"23":{},"24":{},"25":{},"26":{},"37":{},"44":{},"45":{},"46":{},"47":{},"48":{},"49":{},"51":{},"52":{},"53":{},"54":{},"55":{},"56":{},"57":{},"58":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{}}}],["role-arn",{"_index":190,"title":{},"description":{"4":{}}}],["role-bas",{"_index":469,"title":{},"description":{"7":{},"9":{},"20":{}}}],["role](./entities.md#catalog-rol",{"_index":253,"title":{},"description":{"4":{}}}],["role](./entities.md#principal-rol",{"_index":252,"title":{},"description":{"4":{}}}],["role](./img/quickstart/privilege-illustration-2.png",{"_index":268,"title":{},"description":{"4":{}}}],["role](access-control.md#catalog-rol",{"_index":477,"title":{},"description":{"7":{}}}],["role](access-control.md#principal-rol",{"_index":468,"title":{},"description":{"7":{}}}],["role_arn",{"_index":191,"title":{},"description":{"4":{}}}],["roles](#catalog-rol",{"_index":576,"title":{},"description":{"19":{}}}],["roles](#principal-rol",{"_index":564,"title":{},"description":{"16":{},"18":{}}}],["root",{"_index":149,"title":{},"description":{"3":{},"5":{}}}],["rotat",{"_index":731,"title":{},"description":{"43":{}}}],["rotatecredenti",{"_index":730,"title":{"43":{}},"description":{}}],["rout",{"_index":781,"title":{},"description":{"66":{},"77":{},"80":{}}}],["run",{"_index":60,"title":{},"description":{"1":{},"2":{},"4":{},"5":{},"7":{},"9":{},"22":{},"27":{},"30":{}}}],["runapp",{"_index":117,"title":{},"description":{"2":{}}}],["s3",{"_index":187,"title":{},"description":{"4":{},"7":{},"12":{}}}],["same",{"_index":271,"title":{},"description":{"4":{},"7":{},"17":{},"18":{},"22":{},"23":{},"68":{}}}],["sampl",{"_index":385,"title":{},"description":{"7":{}}}],["satisfi",{"_index":32,"title":{},"description":{"1":{},"2":{}}}],["schema",{"_index":518,"title":{},"description":{"9":{}}}],["scienc",{"_index":595,"title":{},"description":{"22":{}}}],["scientist",{"_index":654,"title":{},"description":{"26":{}}}],["scope",{"_index":580,"title":{},"description":{"19":{}}}],["secret",{"_index":299,"title":{},"description":{"5":{},"7":{},"68":{}}}],["section",{"_index":233,"title":{},"description":{"4":{},"7":{},"9":{},"20":{},"25":{}}}],["secur",{"_index":376,"title":{"9":{},"21":{},"29":{}},"description":{"6":{},"7":{},"9":{},"20":{},"21":{},"22":{},"27":{},"29":{},"30":{}}}],["see",{"_index":118,"title":{},"description":{"2":{},"3":{},"4":{},"6":{},"7":{},"9":{},"11":{},"12":{},"13":{},"14":{},"15":{},"16":{},"17":{},"19":{},"20":{},"27":{}}}],["select",{"_index":819,"title":{},"description":{"70":{}}}],["send",{"_index":814,"title":{"84":{},"85":{}},"description":{"68":{},"77":{}}}],["serv",{"_index":3,"title":{},"description":{"0":{}}}],["server",{"_index":136,"title":{},"description":{"2":{},"5":{},"27":{},"30":{},"66":{},"71":{},"75":{},"83":{},"93":{}}}],["servic",{"_index":180,"title":{},"description":{"4":{},"7":{},"8":{},"9":{},"16":{},"18":{},"20":{},"22":{},"23":{},"24":{},"25":{},"26":{},"27":{},"29":{},"30":{},"33":{},"77":{}}}],["service(",{"_index":684,"title":{},"description":{"27":{},"29":{}}}],["session",{"_index":307,"title":{},"description":{"5":{},"68":{}}}],["set",{"_index":165,"title":{"66":{},"75":{}},"description":{"3":{},"4":{},"7":{},"12":{},"23":{},"25":{},"27":{},"29":{},"66":{},"71":{},"75":{},"77":{},"80":{}}}],["setcurrentschemaupd",{"_index":846,"title":{},"description":{"77":{},"80":{}}}],["sever",{"_index":5,"title":{},"description":{"0":{},"27":{},"28":{}}}],["shell",{"_index":47,"title":{},"description":{"1":{},"2":{},"3":{},"4":{},"5":{}}}],["short-liv",{"_index":622,"title":{},"description":{"25":{}}}],["show",{"_index":393,"title":{},"description":{"7":{},"8":{},"22":{},"24":{},"26":{}}}],["shown",{"_index":389,"title":{},"description":{"7":{}}}],["shut",{"_index":146,"title":{},"description":{"3":{}}}],["sign",{"_index":645,"title":{},"description":{"26":{}}}],["silver",{"_index":648,"title":{},"description":{"26":{}}}],["similar",{"_index":301,"title":{},"description":{"5":{}}}],["singl",{"_index":438,"title":{},"description":{"7":{},"22":{}}}],["size",{"_index":787,"title":{},"description":{"66":{}}}],["snapshot",{"_index":862,"title":{},"description":{"80":{}}}],["snowflak",{"_index":419,"title":{},"description":{"7":{},"8":{},"26":{}}}],["snowflake-manag",{"_index":431,"title":{},"description":{"7":{}}}],["snowpip",{"_index":646,"title":{},"description":{"26":{}}}],["softwar",{"_index":335,"title":{},"description":{"6":{},"10":{},"11":{},"20":{},"27":{}}}],["somewher",{"_index":218,"title":{},"description":{"4":{}}}],["sourc",{"_index":61,"title":{},"description":{"1":{},"6":{}}}],["spark",{"_index":88,"title":{},"description":{"1":{},"5":{},"7":{}}}],["spark&trad",{"_index":20,"title":{},"description":{"0":{},"7":{},"8":{},"10":{},"26":{}}}],["spark.sql",{"_index":313,"title":{},"description":{"5":{}}}],["spark.sql(\"creat",{"_index":309,"title":{},"description":{"5":{}}}],["spark.sql(\"insert",{"_index":317,"title":{},"description":{"5":{}}}],["spark.sql(\"select",{"_index":320,"title":{},"description":{"5":{}}}],["spark.sql(\"us",{"_index":308,"title":{},"description":{"5":{}}}],["spark.sql.catalog.quickstart_catalog.catalog-impl=org.apache.iceberg.rest.restcatalog",{"_index":292,"title":{},"description":{"5":{}}}],["spark.sql.catalog.quickstart_catalog.credential='xxxx:yyyi",{"_index":294,"title":{},"description":{"5":{}}}],["spark.sql.catalog.quickstart_catalog.header.x-iceberg-access-delegation=tru",{"_index":290,"title":{},"description":{"5":{}}}],["spark.sql.catalog.quickstart_catalog.scope='principal_role:al",{"_index":295,"title":{},"description":{"5":{}}}],["spark.sql.catalog.quickstart_catalog.token-refresh-enabled=tru",{"_index":296,"title":{},"description":{"5":{}}}],["spark.sql.catalog.quickstart_catalog.uri=http://localhost:8181/api/catalog",{"_index":293,"title":{},"description":{"5":{}}}],["spark.sql.catalog.quickstart_catalog.warehouse=quickstart_catalog",{"_index":289,"title":{},"description":{"5":{}}}],["spark.sql.catalog.quickstart_catalog=org.apache.iceberg.spark.sparkcatalog",{"_index":291,"title":{},"description":{"5":{}}}],["spark.sql.extensions=org.apache.iceberg.spark.extensions.icebergsparksessionextens",{"_index":288,"title":{},"description":{"5":{}}}],["spark](https://spark.apache.org",{"_index":28,"title":{},"description":{"1":{},"5":{}}}],["specif",{"_index":366,"title":{},"description":{"6":{},"11":{},"20":{},"27":{},"64":{},"68":{}}}],["specifi",{"_index":220,"title":{},"description":{"4":{},"22":{},"23":{},"25":{},"27":{},"29":{},"30":{},"64":{},"75":{}}}],["specification](https://iceberg.apache.org/spec/#overview",{"_index":402,"title":{},"description":{"7":{}}}],["stage-cr",{"_index":839,"title":{},"description":{"77":{},"80":{}}}],["standalon",{"_index":100,"title":{},"description":{"2":{}}}],["start",{"_index":1,"title":{"0":{}},"description":{"1":{},"2":{},"5":{},"70":{},"77":{},"80":{}}}],["startup",{"_index":160,"title":{},"description":{"3":{}}}],["state",{"_index":532,"title":{},"description":{"10":{},"77":{}}}],["stdout",{"_index":158,"title":{},"description":{"3":{}}}],["storag",{"_index":209,"title":{},"description":{"4":{},"7":{},"9":{},"12":{},"25":{},"27":{},"31":{}}}],["storage-typ",{"_index":186,"title":{},"description":{"4":{}}}],["store",{"_index":142,"title":{},"description":{"3":{},"4":{},"5":{},"7":{},"9":{},"27":{},"30":{},"66":{},"72":{}}}],["stream",{"_index":455,"title":{},"description":{"7":{},"26":{}}}],["string",{"_index":316,"title":{},"description":{"5":{}}}],["structur",{"_index":395,"title":{},"description":{"7":{}}}],["structure.](img/sample-catalog-structure.svg",{"_index":394,"title":{},"description":{"7":{}}}],["structure](overview.md#catalog",{"_index":386,"title":{},"description":{"7":{}}}],["sub",{"_index":812,"title":{},"description":{"68":{}}}],["subject",{"_index":807,"title":{},"description":{"68":{}}}],["subresourc",{"_index":775,"title":{},"description":{"64":{}}}],["subsequ",{"_index":804,"title":{},"description":{"68":{},"77":{},"79":{},"89":{}}}],["subset",{"_index":770,"title":{},"description":{"64":{}}}],["successfulli",{"_index":243,"title":{},"description":{"4":{}}}],["such",{"_index":211,"title":{},"description":{"4":{},"7":{},"13":{},"18":{},"23":{},"27":{},"30":{},"71":{}}}],["suitabl",{"_index":691,"title":{},"description":{"27":{},"30":{}}}],["superset",{"_index":771,"title":{},"description":{"64":{}}}],["suppli",{"_index":489,"title":{},"description":{"7":{}}}],["support",{"_index":82,"title":{},"description":{"1":{},"4":{},"7":{},"19":{},"22":{},"23":{},"24":{},"75":{},"83":{},"93":{}}}],["sure",{"_index":31,"title":{},"description":{"1":{},"2":{},"3":{},"4":{},"5":{},"27":{},"30":{}}}],["symmetric](https://github.com/apache/polaris/blob/b482617bf8cc508b37dbedf3ebc81a9408160a5e/polaris-service/src/main/java/io/polaris/service/auth/jwtsymmetrickeybroker.java#l23",{"_index":678,"title":{},"description":{"27":{},"29":{}}}],["sync",{"_index":423,"title":{},"description":{"7":{}}}],["system",{"_index":526,"title":{},"description":{"9":{},"13":{},"27":{},"31":{}}}],["tabl",{"_index":305,"title":{"14":{},"76":{},"77":{},"78":{},"79":{},"80":{},"81":{},"82":{},"83":{},"85":{},"86":{}},"description":{"5":{},"6":{},"7":{},"8":{},"9":{},"14":{},"18":{},"19":{},"21":{},"22":{},"23":{},"25":{},"26":{},"37":{},"70":{},"76":{},"77":{},"78":{},"79":{},"80":{},"81":{},"82":{},"83":{}}}],["table'",{"_index":409,"title":{},"description":{"7":{},"79":{}}}],["table1",{"_index":505,"title":{},"description":{"8":{}}}],["table_cr",{"_index":615,"title":{},"description":{"25":{}}}],["table_drop",{"_index":616,"title":{},"description":{"25":{}}}],["table_full_metadata",{"_index":625,"title":{},"description":{"25":{}}}],["table_list",{"_index":617,"title":{},"description":{"25":{}}}],["table_read_data",{"_index":621,"title":{},"description":{"25":{}}}],["table_read_properti",{"_index":618,"title":{},"description":{"25":{}}}],["table_write_data",{"_index":623,"title":{},"description":{"25":{}}}],["table_write_properti",{"_index":620,"title":{},"description":{"25":{}}}],["tables](#t",{"_index":538,"title":{},"description":{"12":{},"13":{}}}],["tables](./entities.md#t",{"_index":176,"title":{},"description":{"4":{}}}],["tables](https://iceberg.apache.org/docs/nightly/configur",{"_index":557,"title":{},"description":{"14":{}}}],["take",{"_index":598,"title":{},"description":{"23":{}}}],["target",{"_index":749,"title":{},"description":{"52":{},"61":{}}}],["task",{"_index":403,"title":{},"description":{"7":{}}}],["tax",{"_index":823,"title":{},"description":{"70":{}}}],["team",{"_index":465,"title":{},"description":{"7":{}}}],["temporari",{"_index":514,"title":{},"description":{"9":{}}}],["tenant",{"_index":501,"title":{},"description":{"7":{}}}],["test",{"_index":546,"title":{},"description":{"12":{},"27":{},"28":{},"30":{}}}],["testinlinebearertokenpolarisauthent",{"_index":673,"title":{},"description":{"27":{},"29":{}}}],["those",{"_index":206,"title":{},"description":{"4":{},"5":{},"22":{}}}],["three",{"_index":797,"title":{},"description":{"68":{}}}],["time",{"_index":120,"title":{},"description":{"2":{},"4":{},"5":{}}}],["togeth",{"_index":267,"title":{},"description":{"4":{},"7":{},"22":{}}}],["token",{"_index":670,"title":{"68":{}},"description":{"27":{},"29":{},"68":{},"79":{},"89":{}}}],["tokenbrok",{"_index":668,"title":{},"description":{"27":{},"29":{}}}],["top-level",{"_index":174,"title":{},"description":{"4":{},"7":{},"12":{},"70":{}}}],["trademark",{"_index":530,"title":{},"description":{"10":{}}}],["transact",{"_index":837,"title":{},"description":{"77":{},"80":{}}}],["transform",{"_index":459,"title":{},"description":{"7":{}}}],["translat",{"_index":821,"title":{},"description":{"70":{}}}],["trino",{"_index":460,"title":{},"description":{"7":{}}}],["true",{"_index":773,"title":{},"description":{"64":{},"77":{},"80":{}}}],["trust",{"_index":486,"title":{},"description":{"7":{}}}],["turn",{"_index":579,"title":{},"description":{"19":{},"26":{}}}],["tutori",{"_index":139,"title":{},"description":{"3":{}}}],["two",{"_index":415,"title":{},"description":{"7":{},"9":{},"66":{},"80":{}}}],["type",{"_index":210,"title":{},"description":{"4":{},"7":{},"9":{},"12":{},"27":{},"31":{},"68":{},"79":{},"89":{}}}],["type_",{"_index":543,"title":{},"description":{"12":{}}}],["ul><li>default",{"_index":491,"title":{},"description":{"7":{}}}],["uncom",{"_index":674,"title":{},"description":{"27":{},"29":{}}}],["under",{"_index":179,"title":{},"description":{"4":{},"6":{},"7":{},"8":{},"11":{},"20":{},"27":{},"76":{},"87":{}}}],["underneath",{"_index":817,"title":{"70":{},"76":{},"87":{}},"description":{}}],["understand",{"_index":587,"title":{},"description":{"20":{}}}],["uniqu",{"_index":562,"title":{},"description":{"16":{}}}],["unit",{"_index":531,"title":{},"description":{"10":{}}}],["unless",{"_index":355,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["unmanag",{"_index":511,"title":{},"description":{"8":{}}}],["unsecur",{"_index":810,"title":{},"description":{"68":{}}}],["up",{"_index":110,"title":{},"description":{"2":{},"23":{},"26":{}}}],["updat",{"_index":303,"title":{"80":{},"86":{}},"description":{"5":{},"7":{},"23":{},"36":{},"41":{},"50":{},"59":{},"75":{},"80":{},"90":{}}}],["updatecatalog",{"_index":720,"title":{"36":{}},"description":{}}],["updatecatalogrol",{"_index":761,"title":{"59":{}},"description":{}}],["updateprincip",{"_index":728,"title":{"41":{}},"description":{}}],["updateprincipalrol",{"_index":746,"title":{"50":{}},"description":{}}],["urn:ietf:params:oauth:token-type:jwt=<jwt-token",{"_index":855,"title":{},"description":{"79":{},"89":{}}}],["us",{"_index":19,"title":{"5":{},"68":{},"78":{}},"description":{"0":{},"1":{},"2":{},"3":{},"4":{},"5":{},"6":{},"7":{},"8":{},"9":{},"11":{},"12":{},"16":{},"20":{},"22":{},"24":{},"25":{},"26":{},"27":{},"29":{},"30":{},"31":{},"66":{},"68":{},"70":{},"77":{},"78":{},"79":{},"80":{},"89":{}}}],["usag",{"_index":153,"title":{},"description":{"3":{},"27":{},"30":{}}}],["user",{"_index":563,"title":{},"description":{"16":{},"18":{},"26":{},"68":{}}}],["user'",{"_index":734,"title":{},"description":{"43":{}}}],["v1/config",{"_index":793,"title":{},"description":{"66":{}}}],["v1/oauth/token",{"_index":816,"title":{},"description":{"68":{}}}],["v1/{prefix}/namespac",{"_index":827,"title":{},"description":{"70":{},"71":{}}}],["v1/{prefix}/namespaces/{namespac",{"_index":830,"title":{},"description":{"72":{},"73":{},"74":{}}}],["v1/{prefix}/namespaces/{namespace}/properti",{"_index":834,"title":{},"description":{"75":{}}}],["v1/{prefix}/namespaces/{namespace}/regist",{"_index":847,"title":{},"description":{"78":{}}}],["v1/{prefix}/namespaces/{namespace}/t",{"_index":836,"title":{},"description":{"76":{},"77":{}}}],["v1/{prefix}/namespaces/{namespace}/tables/{t",{"_index":856,"title":{},"description":{"79":{},"80":{},"81":{},"82":{}}}],["v1/{prefix}/namespaces/{namespace}/tables/{table}/metr",{"_index":875,"title":{},"description":{"84":{}}}],["v1/{prefix}/namespaces/{namespace}/tables/{table}/notif",{"_index":877,"title":{},"description":{"85":{}}}],["v1/{prefix}/namespaces/{namespace}/view",{"_index":879,"title":{},"description":{"87":{},"88":{}}}],["v1/{prefix}/namespaces/{namespace}/views/{view",{"_index":881,"title":{},"description":{"89":{},"90":{},"91":{},"92":{}}}],["v1/{prefix}/tables/renam",{"_index":872,"title":{},"description":{"83":{}}}],["v1/{prefix}/transactions/commit",{"_index":878,"title":{},"description":{"86":{}}}],["v1/{prefix}/views/renam",{"_index":882,"title":{},"description":{"93":{}}}],["valid",{"_index":544,"title":{},"description":{"12":{},"13":{},"80":{},"83":{},"93":{}}}],["valu",{"_index":318,"title":{},"description":{"5":{},"7":{},"8":{},"75":{},"80":{}}}],["variabl",{"_index":167,"title":{},"description":{"3":{}}}],["variou",{"_index":536,"title":{},"description":{"11":{},"12":{}}}],["vend",{"_index":513,"title":{},"description":{"9":{}}}],["version",{"_index":73,"title":{},"description":{"1":{},"6":{},"7":{},"11":{},"20":{},"27":{}}}],["version](https://mvnrepository.com/artifact/org.apache.iceberg/iceberg-spark",{"_index":282,"title":{},"description":{"5":{}}}],["via",{"_index":23,"title":{},"description":{"1":{},"2":{},"4":{},"7":{}}}],["view",{"_index":559,"title":{"15":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{}},"description":{"15":{},"19":{},"21":{},"25":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{}}}],["view'",{"_index":880,"title":{},"description":{"89":{}}}],["view_creat",{"_index":626,"title":{},"description":{"25":{}}}],["view_drop",{"_index":627,"title":{},"description":{"25":{}}}],["view_full_metadata",{"_index":632,"title":{},"description":{"25":{}}}],["view_list",{"_index":628,"title":{},"description":{"25":{}}}],["view_read_properti",{"_index":629,"title":{},"description":{"25":{}}}],["view_write_properti",{"_index":631,"title":{},"description":{"25":{}}}],["views](#view",{"_index":551,"title":{},"description":{"13":{}}}],["views](./entities.md#view",{"_index":177,"title":{},"description":{"4":{}}}],["views](https://iceberg.apache.org/view-spec",{"_index":560,"title":{},"description":{"15":{}}}],["want",{"_index":89,"title":{},"description":{"1":{}}}],["warehous",{"_index":790,"title":{},"description":{"66":{}}}],["warn",{"_index":666,"title":{},"description":{"27":{},"29":{}}}],["warranti",{"_index":361,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["we'll",{"_index":140,"title":{},"description":{"3":{}}}],["well",{"_index":778,"title":{},"description":{"64":{}}}],["we’v",{"_index":256,"title":{},"description":{"4":{},"5":{}}}],["within",{"_index":270,"title":{},"description":{"4":{},"5":{},"7":{},"12":{},"13":{},"16":{},"17":{},"82":{},"92":{}}}],["without",{"_index":360,"title":{},"description":{"6":{},"9":{},"11":{},"20":{},"27":{},"37":{}}}],["won't",{"_index":597,"title":{},"description":{"23":{}}}],["won’t",{"_index":122,"title":{},"description":{"2":{}}}],["work",{"_index":344,"title":{},"description":{"6":{},"7":{},"11":{},"20":{},"26":{},"27":{}}}],["workflow",{"_index":503,"title":{"8":{}},"description":{"8":{}}}],["write",{"_index":202,"title":{},"description":{"4":{},"6":{},"7":{},"11":{},"20":{},"23":{},"25":{},"27":{}}}],["written",{"_index":417,"title":{},"description":{"7":{}}}],["xxxx",{"_index":247,"title":{},"description":{"4":{},"5":{}}}],["you'll",{"_index":39,"title":{},"description":{"1":{}}}],["you'v",{"_index":102,"title":{},"description":{"2":{}}}],["yourself",{"_index":62,"title":{},"description":{"1":{}}}],["you’ll",{"_index":213,"title":{},"description":{"4":{}}}],["you’r",{"_index":208,"title":{},"description":{"4":{}}}],["yyyi",{"_index":249,"title":{},"description":{"4":{},"5":{}}}],["zone",{"_index":650,"title":{},"description":{"26":{}}}]],"pipeline":[]}},"options":{"theme":{"typography":{"fontFamily":"Roboto, sans-serif"},"logo":{"gutter":"15px"}}}};
+      const __redoc_state = {"menu":{"activeItemIdx":-1},"spec":{"data":{"openapi":"3.0.0","info":{"title":"Apache Polaris (Incubating) Documentation","x-logo":{"url":"./img/logos/polaris-catalog-stacked-logo.svg","altText":"Apache Polaris Logo"},"description":"<!--\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://www.apache.org/licenses/LICENSE-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# Quick Start\n\nThis guide serves as a introduction to several key entities that can be managed with Apache Polaris (Incubating), describes how to build and deploy Polaris locally, and finally includes examples of how to use Polaris with Apache Spark&trade;.\n\n## Prerequisites\n\nThis guide covers building Polaris, deploying it locally or via [Docker](https://www.docker.com/), and interacting with it using the command-line interface and [Apache Spark](https://spark.apache.org/). Before proceeding with Polaris, be sure to satisfy the relevant prerequisites listed here.\n\n### Building and Deploying Polaris\n\nTo get the latest Polaris code, you'll need to clone the repository using [git](https://git-scm.com/). You can install git using [homebrew](https://brew.sh/):\n\n```shell\nbrew install git\n```\n\nThen, use git to clone the Polaris repo:\n\n```shell\ncd ~\ngit clone https://github.com/apache/polaris.git\n```\n\n#### With Docker\n\nIf you plan to deploy Polaris inside [Docker](https://www.docker.com/), you'll need to install docker itself. For example, this can be done using [homebrew](https://brew.sh/):\n\n```shell\nbrew install --cask docker\n```\n\nOnce installed, make sure Docker is running.\n\n#### From Source\n\nIf you plan to build Polaris from source yourself, you will need to satisfy a few prerequisites first.\n\nPolaris is built using [gradle](https://gradle.org/) and is compatible with Java 21. We recommend the use of [jenv](https://www.jenv.be/) to manage multiple Java versions. For example, to install Java 21 via [homebrew](https://brew.sh/) and configure it with jenv: \n\n```shell\ncd ~/polaris\nbrew install openjdk@21 jenv\njenv add $(brew --prefix openjdk@21)\njenv local 21\n```\n\n### Connecting to Polaris\n\nPolaris is compatible with any [Apache Iceberg](https://iceberg.apache.org/) client that supports the REST API. Depending on the client you plan to use, refer to the prerequisites below.\n\n#### With Spark\n\nIf you want to connect to Polaris with [Apache Spark](https://spark.apache.org/), you'll need to start by cloning Spark. As [above](#building-and-deploying-polaris), make sure [git](https://git-scm.com/) is installed first. You can install it with [homebrew](https://brew.sh/):\n\n```shell\nbrew install git\n```\n\nThen, clone Spark and check out a versioned branch. This guide uses [Spark 3.5](https://spark.apache.org/releases/spark-release-3-5-0.html).\n\n```shell\ncd ~\ngit clone https://github.com/apache/spark.git\ncd ~/spark\ngit checkout branch-3.5\n```\n\n## Deploying Polaris\n\nPolaris can be deployed via a lightweight docker image or as a standalone process. Before starting, be sure that you've satisfied the relevant [prerequisites](#building-and-deploying-polaris) detailed above.\n\n### Docker Image\n\nTo start using Polaris in Docker, launch Polaris while Docker is running:\n\n```shell\ncd ~/polaris\ndocker compose -f docker-compose.yml up --build\n```\n\nOnce the `polaris-polaris` container is up, you can continue to [Defining a Catalog](#defining-a-catalog).\n\n### Building Polaris\n\nRun Polaris locally with:\n\n```shell\ncd ~/polaris\n./gradlew runApp\n```\n\nYou should see output for some time as Polaris builds and starts up. Eventually, you won’t see any more logs and should see messages that resemble the following:\n\n```\nINFO  [...] [main] [] o.e.j.s.handler.ContextHandler: Started i.d.j.MutableServletContextHandler@...\nINFO  [...] [main] [] o.e.j.server.AbstractConnector: Started application@...\nINFO  [...] [main] [] o.e.j.server.AbstractConnector: Started admin@...\nINFO  [...] [main] [] o.eclipse.jetty.server.Server: Started Server@...\n```\n\nAt this point, Polaris is running.\n\n## Bootstrapping Polaris\n\nFor this tutorial, we'll launch an instance of Polaris that stores entities only in-memory. This means that any entities that you define will be destroyed when Polaris is shut down. It also means that Polaris will automatically bootstrap itself with root credentials. For more information on how to configure Polaris for production usage, see the [docs](./configuring-polaris-for-production.md).\n\nWhen Polaris is launched using in-memory mode the root principal credentials can be found in stdout on initial startup. For example:\n\n```\nrealm: default-realm root principal credentials: <client-id>:<client-secret>\n```\n\nBe sure to note of these credentials as we'll be using them below. You can also set these credentials as environment variables for use with the Polaris CLI:\n\n```shell\nexport CLIENT_ID=<client-id> \nexport CLIENT_SECRET=<client-secret>\n```\n\n## Defining a Catalog\n\nIn Polaris, the [catalog](./entities.md#catalog) is the top-level entity that objects like [tables](./entities.md#table) and [views](./entities.md#view) are organized under. With a Polaris service running, you can create a catalog like so:\n\n```shell\ncd ~/polaris\n\n./polaris \\\n  --client-id ${CLIENT_ID} \\\n  --client-secret ${CLIENT_SECRET} \\\n  catalogs \\\n  create \\\n  --storage-type s3 \\\n  --default-base-location ${DEFAULT_BASE_LOCATION} \\\n  --role-arn ${ROLE_ARN} \\\n  quickstart_catalog\n```\n\nThis will create a new catalog called **quickstart_catalog**.\n\nThe `DEFAULT_BASE_LOCATION` you provide will be the default location that objects in this catalog should be stored in, and the `ROLE_ARN` you provide should be a [Role ARN](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) with access to read and write data in that location. These credentials will be provided to engines reading data from the catalog once they have authenticated with Polaris using credentials that have access to those resources.\n\nIf you’re using a storage type other than S3, such as Azure, you’ll provide a different type of credential than a Role ARN. For more details on supported storage types, see the [docs](./entities.md#storage-type).\n\nAdditionally, if Polaris is running somewhere other than `localhost:8181`, you can specify the correct hostname and port by providing `--host` and `--port` flags. For the full set of options supported by the CLI, please refer to the [docs](./command-line-interface.md).\n\n\n### Creating a Principal and Assigning it Privileges\n\nWith a catalog created, we can create a [principal](./entities.md#principal) that has access to manage that catalog. For details on how to configure the Polaris CLI, see [the section above](#defining-a-catalog) or refer to the [docs](./command-line-interface.md).\n\n```shell\n./polaris \\\n  --client-id ${CLIENT_ID} \\\n  --client-secret ${CLIENT_SECRET} \\\n  principals \\\n  create \\\n  quickstart_user\n\n./polaris \\\n  --client-id ${CLIENT_ID} \\\n  --client-secret ${CLIENT_SECRET} \\\n  principal-roles \\\n  create \\\n  quickstart_user_role\n\n./polaris \\\n  --client-id ${CLIENT_ID} \\\n  --client-secret ${CLIENT_SECRET} \\\n  catalog-roles \\\n  create \\\n  --catalog quickstart_catalog \\\n  quickstart_catalog_role\n```\n\nBe sure to provide the necessary credentials, hostname, and port as before.\n\nWhen the `principals create` command completes successfully, it will return the credentials for this new principal. Be sure to note these down for later. For example:\n\n```\n./polaris ... principals create example\n{\"clientId\": \"XXXX\", \"clientSecret\": \"YYYY\"}\n```\n\nNow, we grant the principal the [principal role](./entities.md#principal-role) we created, and grant the [catalog role](./entities.md#catalog-role) the principal role we created. For more information on these entities, please refer to the linked documentation.\n\n```shell\n./polaris \\\n  --client-id ${CLIENT_ID} \\\n  --client-secret ${CLIENT_SECRET} \\\n  principal-roles \\\n  grant \\\n  --principal quickstart_user \\\n  quickstart_user_role\n\n./polaris \\\n  --client-id ${CLIENT_ID} \\\n  --client-secret ${CLIENT_SECRET} \\\n  catalog-roles \\\n  grant \\\n  --catalog quickstart_catalog \\\n  --principal-role quickstart_user_role \\\n  quickstart_catalog_role\n```\n\nNow, we’ve linked our principal to the catalog via roles like so:\n\n![Principal to Catalog](./img/quickstart/privilege-illustration-1.png \"Principal to Catalog\")\n\nIn order to give this principal the ability to interact with the catalog, we must assign some [privileges](./entities.md#privilege). For the time being, we will give this principal the ability to fully manage content in our new catalog. We can do this with the CLI like so:\n\n```shell\n./polaris \\\n  --client-id ${CLIENT_ID} \\\n  --client-secret ${CLIENT_SECRET} \\\n  privileges \\\n  catalog \\\n  grant \\\n  --catalog quickstart_catalog \\\n  --catalog-role quickstart_catalog_role \\\n  CATALOG_MANAGE_CONTENT\n```\n\nThis grants the [catalog privileges](./entities.md#privilege) `CATALOG_MANAGE_CONTENT` to our catalog role, linking everything together like so:\n\n![Principal to Catalog with Catalog Role](./img/quickstart/privilege-illustration-2.png \"Principal to Catalog with Catalog Role\")\n\n`CATALOG_MANAGE_CONTENT` has create/list/read/write privileges on all entities within the catalog. The same privilege could be granted to a namespace, in which case the principal could create/list/read/write any entity under that namespace.\n\n## Using Iceberg & Polaris\n\nAt this point, we’ve created a principal and granted it the ability to manage a catalog. We can now use an external engine to assume that principal, access our catalog, and store data in that catalog using [Apache Iceberg](https://iceberg.apache.org/).\n\n### Connecting with Spark\n\nTo use a Polaris-managed catalog in [Apache Spark](https://spark.apache.org/), we can configure Spark to use the Iceberg catalog REST API.\n\nThis guide uses [Apache Spark 3.5](https://spark.apache.org/releases/spark-release-3-5-0.html), but be sure to find [the appropriate iceberg-spark package for your Spark version](https://mvnrepository.com/artifact/org.apache.iceberg/iceberg-spark). From a local Spark clone on the `branch-3.5` branch we can run the following:\n\n_Note: the credentials provided here are those for our principal, not the root credentials._\n\n```shell\nbin/spark-shell \\\n--packages org.apache.iceberg:iceberg-spark-runtime-3.5_2.12:1.5.2,org.apache.hadoop:hadoop-aws:3.4.0 \\\n--conf spark.sql.extensions=org.apache.iceberg.spark.extensions.IcebergSparkSessionExtensions \\\n--conf spark.sql.catalog.quickstart_catalog.warehouse=quickstart_catalog \\\n--conf spark.sql.catalog.quickstart_catalog.header.X-Iceberg-Access-Delegation=vended-credentials \\\n--conf spark.sql.catalog.quickstart_catalog=org.apache.iceberg.spark.SparkCatalog \\\n--conf spark.sql.catalog.quickstart_catalog.catalog-impl=org.apache.iceberg.rest.RESTCatalog \\\n--conf spark.sql.catalog.quickstart_catalog.uri=http://localhost:8181/api/catalog \\\n--conf spark.sql.catalog.quickstart_catalog.credential='XXXX:YYYY' \\\n--conf spark.sql.catalog.quickstart_catalog.scope='PRINCIPAL_ROLE:ALL' \\\n--conf spark.sql.catalog.quickstart_catalog.token-refresh-enabled=true\n```\n\n\nReplace `XXXX` and `YYYY` with the client ID and client secret generated when you created the `quickstart_user` principal.\n\nSimilar to the CLI commands above, this configures Spark to use the Polaris running at `localhost:8181`. If your Polaris server is running elsewhere, but sure to update the configuration appropriately.\n\nFinally, note that we include the `hadoop-aws` package here. If your table is using a different filesystem, be sure to include the appropriate dependency.\n\nOnce the Spark session starts, we can create a namespace and table within the catalog:\n\n```\nspark.sql(\"USE quickstart_catalog\")\nspark.sql(\"CREATE NAMESPACE IF NOT EXISTS quickstart_namespace\")\nspark.sql(\"CREATE NAMESPACE IF NOT EXISTS quickstart_namespace.schema\")\nspark.sql(\"USE NAMESPACE quickstart_namespace.schema\")\nspark.sql(\"\"\"\n\tCREATE TABLE IF NOT EXISTS quickstart_table (\n\t\tid BIGINT, data STRING\n\t) \nUSING ICEBERG\n\"\"\")\n```\n\nWe can now use this table like any other:\n\n```\nspark.sql(\"INSERT INTO quickstart_table VALUES (1, 'some data')\")\nspark.sql(\"SELECT * FROM quickstart_table\").show(false)\n. . .\n+---+---------+\n|id |data     |\n+---+---------+\n|1  |some data|\n+---+---------+\n```\n\nIf at any time access is revoked...\n\n```shell\n./polaris \\\n  --client-id ${CLIENT_ID} \\\n  --client-secret ${CLIENT_SECRET} \\\n  privileges \\\n  catalog \\\n  revoke \\\n  --catalog quickstart_catalog \\\n  --catalog-role quickstart_catalog_role \\\n  CATALOG_MANAGE_CONTENT\n```\n\nSpark will lose access to the table:\n\n```\nspark.sql(\"SELECT * FROM quickstart_table\").show(false)\n\norg.apache.iceberg.exceptions.ForbiddenException: Forbidden: Principal 'quickstart_user' with activated PrincipalRoles '[]' and activated ids '[6, 7]' is not authorized for op LOAD_TABLE_WITH_READ_DELEGATION\n```\n","contact":{"email":"dev [at] polaris.apache.org","url":"https://github.com/apache/polaris"},"license":{"name":"Apache v2.0","url":"https://github.com/apache/polaris/blob/main/LICENSE"}},"servers":[{"url":"{scheme}://{host}/api/management/v1","description":"Server URL when the port can be inferred from the scheme","variables":{"scheme":{"description":"The scheme of the URI, either http or https.","default":"https"},"host":{"description":"The host address for the specified server","default":"localhost"}}},{"url":"{scheme}://{host}/{basePath}","description":"Server URL when the port can be inferred from the scheme","variables":{"scheme":{"description":"The scheme of the URI, either http or https.","default":"https"},"host":{"description":"The host address for the specified server","default":"localhost"},"basePath":{"description":"Optional prefix to be appended to all routes","default":""}}},{"url":"{scheme}://{host}:{port}/{basePath}","description":"Generic base server URL, with all parts configurable","variables":{"scheme":{"description":"The scheme of the URI, either http or https.","default":"https"},"host":{"description":"The host address for the specified server","default":"localhost"},"port":{"description":"The port used when addressing the host","default":"443"},"basePath":{"description":"Optional prefix to be appended to all routes","default":""}}}],"tags":[{"name":"Overview","description":"<!--\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://www.apache.org/licenses/LICENSE-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\nApache Polaris (Incubating) is a catalog implementation for Apache Iceberg&trade; tables and is built on the open source Apache Iceberg&trade; REST protocol.\n\nWith Polaris, you can provide centralized, secure read and write access to your Iceberg tables across different REST-compatible query engines.\n\n![Conceptual diagram of Apache Polaris (Incubating).](img/overview.svg \"Apache Polaris (Incubating) overview\")\n\n## Key concepts\n\nThis section introduces key concepts associated with using Apache Polaris (Incubating).\n\nIn the following diagram, a sample [Apache Polaris (Incubating) structure](overview.md#catalog) with nested [namespaces](overview.md#namespace) is shown for Catalog1. No tables\nor namespaces have been created yet for Catalog2 or Catalog3.\n\n![Diagram that shows an example Apache Polaris (Incubating) structure.](img/sample-catalog-structure.svg \"Sample Apache Polaris (Incubating) structure\")\n\n### Catalog\n\nIn Polaris, you can create one or more catalog resources to organize Iceberg tables.\n\nConfigure your catalog by setting values in the storage configuration for S3, Azure, or Google Cloud Storage. An Iceberg catalog enables a\nquery engine to manage and organize tables. The catalog forms the first architectural layer in the [Apache Iceberg&trade; table specification](https://iceberg.apache.org/spec/#overview) and must support the following tasks:\n\n- Storing the current metadata pointer for one or more Iceberg tables. A metadata pointer maps a table name to the location of that table's\n    current metadata file.\n\n- Performing atomic operations so that you can update the current metadata pointer for a table to the metadata pointer of a new version of\n  the table.\n\nTo learn more about Iceberg catalogs, see the [Apache Iceberg&trade; documentation](https://iceberg.apache.org/concepts/catalog/).\n\n#### Catalog types\n\nA catalog can be one of the following two types:\n\n- Internal: The catalog is managed by Polaris. Tables from this catalog can be read and written in Polaris.\n\n- External: The catalog is externally managed by another Iceberg catalog provider (for example, Snowflake, Glue, Dremio Arctic). Tables from \n  this catalog are synced to Polaris. These tables are read-only in Polaris. In the current release, only a Snowflake external catalog is provided.\n\nA catalog is configured with a storage configuration that can point to S3, Azure storage, or GCS.\n\n### Namespace\n\nYou create *namespaces* to logically group Iceberg tables within a catalog. A catalog can have multiple namespaces. You can also create\nnested namespaces. Iceberg tables belong to namespaces.\n\n### Apache Iceberg&trade; tables and catalogs\n\nIn an internal catalog, an Iceberg table is registered in Polaris, but read and written via query engines. The table data and\nmetadata is stored in your external cloud storage. The table uses Polaris as the Iceberg catalog.\n\nIf you have tables that use Snowflake as the Iceberg catalog (Snowflake-managed tables), you can sync these tables to an external\ncatalog in Polaris. If you sync this catalog to Polaris, it appears as an external catalog in Polaris. The table data and\nmetadata is stored in your external cloud storage. The Snowflake query engine can read from or write to these tables. However, the other query\nengines can only read from these tables.\n\n> **Important**\n>\n> For the access privileges defined for a catalog to be enforced correctly, the following conditions must be met:\n>\n> - The directory only contains the data files that belong to a single table.\n> - The directory hierarchy matches the namespace hierarchy for the catalog.\n>\n> For example, if a catalog includes the following items:\n>\n> - Top-level namespace namespace1\n> - Nested namespace namespace1a\n> - A customers table, which is grouped under nested namespace namespace1a\n> - An orders table, which is grouped under nested namespace namespace1a\n>\n> The directory hierarchy for the catalog must follow this structure:\n>\n> - /namespace1/namespace1a/customers/<files for the customers table *only*>\n> - /namespace1/namespace1a/orders/<files for the orders table *only*>\n\n### Service principal\n\nA service principal is an entity that you create in Polaris. Each service principal encapsulates credentials that you use to connect\nto Polaris.\n\nQuery engines use service principals to connect to catalogs.\n\nPolaris generates a Client ID and Client Secret pair for each service principal.\n\nThe following table displays example service principals that you might create in Polaris:\n\n  | Service connection name     | Purpose |\n  | --------------------------- | ----------- |\n  |  Flink ingestion            | For Apache Flink&reg; to ingest streaming data into Apache Iceberg&trade; tables. |\n  |  Spark ETL pipeline         | For Apache Spark&trade; to run ETL pipeline jobs on Iceberg tables. |\n  |  Snowflake data pipelines   | For Snowflake to run data pipelines for transforming data in Apache Iceberg&trade; tables.  |\n  |  Trino BI dashboard         | For Trino to run BI queries for powering a dashboard. |\n  |  Snowflake AI team          | For Snowflake to run AI jobs on data in Apache Iceberg&trade; tables. |\n\n### Service connection\n\nA service connection represents a REST-compatible engine (such as Apache Spark&trade;, Apache Flink&reg;, or Trino) that can read from and write to Polaris\nCatalog. When creating a new service connection, the Polaris administrator grants the service principal that is created with the new service \nconnection either a new or existing principal role. A principal role is a resource in Polaris that you can use to logically group Polaris \nservice principals together and grant privileges on securable objects. For more information, see [Principal role](access-control.md#principal-role \"Principal role\"). Polaris uses a role-based access control (RBAC) model to grant service principals access to resources. For more information, \nsee [Access control](access-control.md \"Access control\"). For a diagram of this model, see [RBAC model](access-control.md#rbac-model \"RBAC model\").\n\nIf the Polaris administrator grants the service principal for the new service connection a new principal role, the service principal\ndoesn't have any privileges granted to it yet. When securing the catalog that the new service connection will connect to, the Polaris\nadministrator grants privileges to catalog roles and then grants these catalog roles to the new principal role. As a result, the service\nprincipal for the new service connection has these privileges. For more information about catalog roles, see [Catalog role](access-control.md#catalog-role \"Catalog role\").\n\nIf the Polaris administrator grants an existing principal role to the service principal for the new service connection, the service principal\nhas the same privileges granted to the catalog roles that are granted to the existing principal role. If needed, the Polaris\nadministrator can grant additional catalog roles to the existing principal role or remove catalog roles from it to adjust the privileges\nbestowed to the service principal. For an example of how RBAC works in Polaris, see [RBAC example](access-control.md#rbac-example \"RBAC example\").\n\n### Storage configuration\n\nA storage configuration stores a generated identity and access management (IAM) entity for your external cloud storage and is created\nwhen you create a catalog. The storage configuration is used to set the values to connect Polaris to your cloud storage. During the\ncatalog creation process, an IAM entity is generated and used to create a trust relationship between the cloud storage provider and Polaris\nCatalog.\n\nWhen you create a catalog, you supply the following information about your external cloud storage:\n\n| Cloud storage provider | Information |\n| -----------------------| ----------- |\n| Amazon S3 | <ul><li>Default base location for your Amazon S3 bucket</li><li>Locations for your Amazon S3 bucket</li><li>S3 role ARN</li><li>External ID (optional)</li></ul> |\n| Google Cloud Storage (GCS) | <ul><li>Default base location for your GCS bucket</li><li>Locations for your GCS bucket</li></ul> |\n| Azure | <ul><li>Default base location for your Microsoft Azure container</li><li>Locations for your Microsoft Azure container</li><li>Azure tenant ID</li></ul> |\n\n## Example workflow\n\nIn the following example workflow, Bob creates an Apache Iceberg&trade; table named Table1 and Alice reads data from Table1.\n\n1.  Bob uses Apache Spark&trade; to create the Table1 table under the\n    Namespace1 namespace in the Catalog1 catalog and insert values into\n    Table1.\n\n    Bob can create Table1 and insert data into it because he is using a\n    service connection with a service principal that has\n    the privileges to perform these actions.\n\n2.  Alice uses Snowflake to read data from Table1.\n\n    Alice can read data from Table1 because she is using a service\n    connection with a service principal with a catalog integration that\n    has the privileges to perform this action. Alice\n    creates an unmanaged table in Snowflake to read data from Table1.\n\n![Diagram that shows an example workflow for Apache Polaris (Incubating)](img/example-workflow.svg \"Example workflow for Apache Polaris (Incubating)\")\n\n## Security and access control\n\nThis section describes security and access control.\n\n### Credential vending\n\nTo secure interactions with service connections, Polaris vends temporary storage credentials to the query engine during query\nexecution. These credentials allow the query engine to run the query without requiring access to your external cloud storage for\nIceberg tables. This process is called credential vending.\n\n### Identity and access management (IAM)\n\nPolaris uses the identity and access management (IAM) entity to securely connect to your storage for accessing table data, Iceberg\nmetadata, and manifest files that store the table schema, partitions, and other metadata. Polaris retains the IAM entity for your\nstorage location.\n\n### Access control\n\nPolaris enforces the access control that you configure across all tables registered with the service and governs security for all\nqueries from query engines in a consistent manner.\n\nPolaris uses a role-based access control (RBAC) model that lets you centrally configure access for Polaris service principals to catalogs,\nnamespaces, and tables.\n\nPolaris RBAC uses two different role types to delegate privileges:\n\n- **Principal roles:** Granted to Polaris service principals and\n  analogous to roles in other access control systems that you grant to\n  service principals.\n\n- **Catalog roles:** Configured with certain privileges on Polaris\n  catalog resources and granted to principal roles.\n\nFor more information, see [Access control](access-control.md \"Access control\").\n\n## Legal Notices\n\nApache&reg;, Apache Iceberg&trade;, Apache Spark&trade;, Apache Flink&reg;, and Flink&reg; are either registered trademarks or trademarks of the Apache Software Foundation in the United States and/or other countries.\n","x-displayName":"Overview"},{"name":"Polaris Entities","description":"<!--\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://www.apache.org/licenses/LICENSE-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\nThis page documents various entities that can be managed in Apache Polaris (Incubating).\n\n## Catalog\n\nA catalog is a top-level entity in Polaris that may contain other entities like [namespaces](#namespace) and [tables](#table). These map directly to [Apache Iceberg catalogs](https://iceberg.apache.org/concepts/catalog/).\n\nFor information on managing catalogs with the REST API or for more information on what data can be associated with a catalog, see [the API docs](../regtests/client/python/docs/CreateCatalogRequest.md).\n\n### Storage Type\n\nAll catalogs in Polaris are associated with a _storage type_. Valid Storage Types are `S3`, `Azure`, and `GCS`. The `FILE` type is also additionally available for testing. Each of these types relates to a different storage provider where data within the catalog may reside. Depending on the storage type, various other configurations may be set for a catalog including credentials to be used when accessing data inside the catalog.\n\nFor details on how to use Storage Types in the REST API, see [the API docs](../regtests/client/python/docs/StorageConfigInfo.md).\n\n## Namespace\n\nA namespace is a logical entity that resides within a [catalog](#catalog) and can contain other entities such as [tables](#table) or [views](#view). Some other systems may refer to namespaces as _schemas_ or _databases_.\n\nIn Polaris, namespaces can be nested. For example, `a.b.c.d.e.f.g` is a valid namespace. `b` is said to reside within `a`, and so on.\n\nFor information on managing namespaces with the REST API or for more information on what data can be associated with a namespace, see [the API docs](../regtests/client/python/docs/CreateNamespaceRequest.md).\n\n\n## Table\n\nPolaris tables are entities that map to [Apache Iceberg tables](https://iceberg.apache.org/docs/nightly/configuration/).\n\nFor information on managing tables with the REST API or for more information on what data can be associated with a table, see [the API docs](../regtests/client/python/docs/CreateTableRequest.md).\n\n## View\n\nPolaris views are entities that map to [Apache Iceberg views](https://iceberg.apache.org/view-spec/).\n\nFor information on managing views with the REST API or for more information on what data can be associated with a view, see [the API docs](../regtests/client/python/docs/CreateViewRequest.md).\n\n## Principal\n\nPolaris principals are unique identities that can be used to represent users or services. Each principal may have one or more [principal roles](#principal-role) assigned to it for the purpose of accessing catalogs and the entities within them.\n\nFor information on managing principals with the REST API or for more information on what data can be associated with a principal, see [the API docs](../regtests/client/python/docs/CreatePrincipalRequest.md).\n\n## Principal Role\n\nPolaris principal roles are labels that may be granted to [principals](#principal). Each principal may have one or more principal roles, and the same principal role may be granted to multiple principals. Principal roles may be assigned based on the persona or responsibilities of a given principal, or on how that principal will need to access different entities within Polaris.\n\nFor information on managing principal roles with the REST API or for more information on what data can be associated with a principal role, see [the API docs](../regtests/client/python/docs/CreatePrincipalRoleRequest.md).\n\n\n## Catalog Role\n\nPolaris catalog roles are labels that may be granted to [catalogs](#catalog). Each catalog may have one or more catalog roles, and the same catalog role may be granted to multiple catalogs. Catalog roles may be assigned based on the nature of data that will reside in a catalog, or by the groups of users and services that might need to access that data. \n\nEach catalog role may have multiple [privileges](#privilege) granted to it, and each catalog role can be granted to one or more [principal roles](#principal-role). This is the mechanism by which principals are granted access to entities inside a catalog such as namespaces and tables.\n\n## Privilege\n\nPolaris privileges are granted to [catalog roles](#catalog-role) in order to grant principals with a given principal role some degree of access to catalogs with a given catalog role. When a privilege is granted to a catalog role, any principal roles granted that catalog role receive the privilege. In turn, any principals who are granted that principal role receive it. \n\nA privilege can be scoped to any entity inside a catalog, including the catalog itself.\n\nFor a list of supported privileges for each privilege class, see the API docs:\n* [Table Privileges](../regtests/client/python/docs/TablePrivilege.md)\n* [View Privileges](../regtests/client/python/docs/ViewPrivilege.md)\n* [Namespace Privileges](../regtests/client/python/docs/NamespacePrivilege.md)\n* [Catalog Privileges](../regtests/client/python/docs/CatalogPrivilege.md)\n","x-displayName":"Polaris Entities"},{"name":"Access Control","description":"<!--\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://www.apache.org/licenses/LICENSE-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\nThis section provides information about how access control works for Apache Polaris (Incubating).\n\nPolaris uses a role-based access control (RBAC) model in which the Polaris administrator assigns access privileges to catalog roles\nand then grants access to resources to service principals by assigning catalog roles to principal roles.\n\nThese are the key concepts to understanding access control in Polaris:\n\n- **Securable object**\n- **Principal role**\n- **Catalog role**\n- **Privilege**\n\n## Securable object\n\nA securable object is an object to which access can be granted. Polaris\nhas the following securable objects:\n\n- Catalog\n- Namespace\n- Iceberg table\n- View\n\n## Principal role\n\nA principal role is a resource in Polaris that you can use to logically group Polaris service principals together and grant privileges on\nsecurable objects.\n\nPolaris supports a many-to-one relationship between service principals and principal roles. For example, to grant the same privileges to\nmultiple service principals, you can grant a single principal role to those service principals. A service principal can be granted one\nprincipal role. When registering a service connection, the Polaris administrator specifies the principal role that is granted to the\nservice principal.\n\nYou don't grant privileges directly to a principal role. Instead, you configure object permissions at the catalog role level, and then grant\ncatalog roles to a principal role.\n\nThe following table shows examples of principal roles that you might configure in Polaris:\n\n| Principal role name | Description |\n| -----------------------| ----------- |\n| Data_engineer   | A role that is granted to multiple service principals for running data engineering jobs. |\n| Data_scientist | A role that is granted to multiple service principals for running data science or AI jobs. |\n\n## Catalog role\n\nA catalog role belongs to a particular catalog resource in Polaris and specifies a set of permissions for actions on the catalog or objects\nin the catalog, such as catalog namespaces or tables. You can create one or more catalog roles for a catalog.\n\nYou grant privileges to a catalog role and then grant the catalog role to a principal role to bestow the privileges to one or more service\nprincipals.\n\n> **Note**\n>\n> If you update the privileges bestowed to a service principal, the updates won't take effect for up to one hour. This means that if you\n> revoke or grant some privileges for a catalog, the updated privileges won't take effect on any service principal with access to that catalog\n> for up to one hour.\n\nPolaris also supports a many-to-many relationship between catalog roles and principal roles. You can grant the same catalog role to one or more\nprincipal roles. Likewise, a principal role can be granted to one or more catalog roles.\n\nThe following table displays examples of catalog roles that you might\nconfigure in Polaris:\n\n| Example Catalog role | Description |\n| -----------------------| ----------- |\n| Catalog administrators   | A role that has been granted multiple privileges to emulate full access to the catalog.<br /><br />Principal roles that have been granted this role are permitted to create, alter, read, write, and drop tables in the catalog.  |\n| Catalog readers      | A role that has been granted read-only privileges to tables in the catalog.<br /><br />Principal roles that have been granted this role are allowed to read from tables in the catalog. |\n| Catalog contributor   | A role that has been granted read and write access privileges to all tables that belong to the catalog.<br /><br />Principal roles that have been granted this role are allowed to perform read and write operations on tables in the catalog. |\n\n## RBAC model\n\nThe following diagram illustrates the RBAC model used by Polaris. For each catalog, the Polaris administrator assigns access\nprivileges to catalog roles and then grants service principals access to resources by assigning catalog roles to principal roles. Polaris\nsupports a many-to-one relationship between service principals and principal roles.\n\n![Diagram that shows the RBAC model for Apache Polaris.](img/rbac-model.svg \"Apache Polaris RBAC model\")\n\n## Access control privileges\n\nThis section describes the privileges that are available in the Polaris access control model. Privileges are granted to catalog roles, catalog\nroles are granted to principal roles, and principal roles are granted to service principals to specify the operations that service principals can\nperform on objects in Polaris.\n\n> **Important**\n>\n> You can only grant privileges at the catalog level. Fine-grained access controls are not available. For example, you can grant read \n> privileges to all tables in a catalog but not to an individual table in the catalog.\n\nTo grant the full set of privileges (drop, list, read, write, etc.) on an object, you can use the *full privilege* option.\n\n### Table privileges\n\n| Privilege | Description |\n| --------- | ----------- |\n| TABLE_CREATE | Enables registering a table with the catalog. |\n| TABLE_DROP | Enables dropping a table from the catalog. |\n| TABLE_LIST | Enables listing any tables in the catalog. |\n| TABLE_READ_PROPERTIES | Enables reading [properties](https://iceberg.apache.org/docs/nightly/configuration/#table-properties) of the table. |\n| TABLE_WRITE_PROPERTIES | Enables configuring [properties](https://iceberg.apache.org/docs/nightly/configuration/#table-properties) for the table. |\n| TABLE_READ_DATA | Enables reading data from the table by receiving short-lived read-only storage credentials from the catalog. |\n| TABLE_WRITE_DATA | Enables writing data to the table by receiving short-lived read+write storage credentials from the catalog. |\n| TABLE_FULL_METADATA | Grants all table privileges, except TABLE_READ_DATA and TABLE_WRITE_DATA, which need to be granted individually. |\n\n### View privileges\n\n| Privilege | Description |\n| --------- | ----------- |\n| VIEW_CREATE  | Enables registering a view with the catalog. |\n| VIEW_DROP | Enables dropping a view from the catalog. |\n| VIEW_LIST | Enables listing any views in the catalog.  |\n| VIEW_READ_PROPERTIES | Enables reading all the view properties. |\n| VIEW_WRITE_PROPERTIES | Enables configuring view properties. |\n| VIEW_FULL_METADATA | Grants all view privileges. |\n\n### Namespace privileges\n\n| Privilege | Description |\n| --------- | ----------- |\n| NAMESPACE_CREATE | Enables creating a namespace in a catalog. |\n| NAMESPACE_DROP | Enables dropping the namespace from the catalog. |\n| NAMESPACE_LIST | Enables listing any object in the namespace, including nested namespaces and tables. |\n| NAMESPACE_READ_PROPERTIES | Enables reading all the namespace properties. |\n| NAMESPACE_WRITE_PROPERTIES | Enables configuring namespace properties. |\n| NAMESPACE_FULL_METADATA | Grants all namespace privileges. |\n\n### Catalog privileges\n\n| Privilege | Description |\n| -----------------------| ----------- |\n| CATALOG_MANAGE_ACCESS | Includes the ability to grant or revoke privileges on objects in a catalog to catalog roles, and the ability to grant or revoke catalog roles to or from principal roles. |\n| CATALOG_MANAGE_CONTENT | Enables full management of content for the catalog. This privilege encompasses the following privileges:<ul><li>CATALOG_MANAGE_METADATA</li><li>TABLE_FULL_METADATA</li><li>NAMESPACE_FULL_METADATA</li><li>VIEW_FULL_METADATA</li><li>TABLE_WRITE_DATA</li><li>TABLE_READ_DATA</li><li>CATALOG_READ_PROPERTIES</li><li>CATALOG_WRITE_PROPERTIES</li></ul> |\n| CATALOG_MANAGE_METADATA | Enables full management of the catalog, catalog roles, namespaces, and tables.  |\n| CATALOG_READ_PROPERTIES | Enables listing catalogs and reading properties of the catalog. |\n| CATALOG_WRITE_PROPERTIES | Enables configuring catalog properties. |\n\n## RBAC example\n\nThe following diagram illustrates how RBAC works in Polaris and\nincludes the following users:\n\n- **Alice:** A service admin who signs up for Polaris. Alice can\n    create service principals. She can also create catalogs and\n    namespaces and configure access control for Polaris resources.\n\n- **Bob:** A data engineer who uses Snowpipe Streaming (in Snowflake)\n    and Apache Spark&trade; connections to interact with Polaris.\n\n    - Alice has created a service principal for Bob. It has been\n        granted the Data_engineer principal role, which in turn has been\n        granted the following catalog roles: Catalog contributor and\n        Data administrator (for both the Silver and Gold zone catalogs\n        in the following diagram).\n\n    - The Catalog contributor role grants permission to create\n        namespaces and tables in the Bronze zone catalog.\n\n    - The Data administrator roles grant full administrative rights to\n        the Silver zone catalog and Gold zone catalog.\n\n- **Mark:** A data scientist who uses Snowflake AI services to\n    interact with Polaris.\n\n    - Alice has created a service principal for Mark. It has been\n        granted the Data_scientist principal role, which in turn has\n        been granted the catalog role named Catalog reader.\n\n    - The Catalog reader role grants read-only access for a catalog\n        named Gold zone catalog.\n\n![Diagram that shows an example of how RBAC works in Apache Polaris.](img/rbac-example.svg \"Apache Polaris RBAC example\")\n","x-displayName":"Access Control"},{"name":"Configuring Polaris for Production","description":"<!--\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://www.apache.org/licenses/LICENSE-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\n# Configuring Apache Polaris (Incubating) for Production\n\nThe default `polaris-server.yml` configuration is intended for develoment and testing. When deploying Polaris in production, there are several best practices to keep in mind.\n\n## Security\n\n### Configurations\n\nNotable configuration used to secure a Polaris deployment are outlined below.\n\n#### oauth2\n\n> [!WARNING]  \n> Ensure that the `tokenBroker` setting reflects the token broker specified in `authenticator` below.\n\n* Configure [OAuth](https://oauth.net/2/) with this setting. Remove the `TestInlineBearerTokenPolarisAuthenticator` option and uncomment the `DefaultPolarisAuthenticator` authenticator option beneath it.\n* Then, configure the token broker. You can configure the token broker to use either [asymmetric](https://github.com/apache/polaris/blob/b482617bf8cc508b37dbedf3ebc81a9408160a5e/polaris-service/src/main/java/io/polaris/service/auth/JWTRSAKeyPair.java#L24) or [symmetric](https://github.com/apache/polaris/blob/b482617bf8cc508b37dbedf3ebc81a9408160a5e/polaris-service/src/main/java/io/polaris/service/auth/JWTSymmetricKeyBroker.java#L23) keys.\n\n#### authenticator.tokenBroker\n\n> [!WARNING]  \n> Ensure that the `tokenBroker` setting reflects the token broker specified in `oauth2` above.\n\n#### callContextResolver & realmContextResolver\n* Use these configurations to specify a service that can resolve a realm from bearer tokens.\n* The service(s) used here must implement the relevant interfaces (i.e. [CallContextResolver](https://github.com/apache/polaris/blob/8290019c10290a600e40b35ddb1e2f54bf99e120/polaris-service/src/main/java/io/polaris/service/context/CallContextResolver.java#L27) and [RealmContextResolver](https://github.com/apache/polaris/blob/7ce86f10a68a3b56aed766235c88d6027c0de038/polaris-service/src/main/java/io/polaris/service/context/RealmContextResolver.java)).\n\n## Metastore Management\n\n> [!IMPORTANT]  \n> The default `in-memory` implementation for `metastoreManager` is meant for testing and not suitable for production usage. Instead, consider an implementation such as `eclipse-link` which allows you to store metadata in a remote database.\n\nA Metastore Manger should be configured with an implementation that durably persists Polaris entities. Use the configuration `metaStoreManager` to configure a [MetastoreManager](https://github.com/apache/polaris/blob/627dc602eb15a3258dcc32babf8def34cf6de0e9/polaris-core/src/main/java/io/polaris/core/persistence/PolarisMetaStoreManager.java#L47) implementation where Polaris entities will be persisted. \n\nBe sure to secure your metastore backend since it will be storing credentials and catalog metadata.\n\n### Configuring EclipseLink\n\nTo use [EclipseLink](https://eclipse.dev/eclipselink/) for metastore management, specify the configuration `metaStoreManager.conf-file` to point to an [EclipseLink `persistence.xml` file](https://eclipse.dev/eclipselink/documentation/2.5/solutions/testingjpa002.htm). This file, local to the Polaris service, will contain information on what database to use for metastore management and how to connect to it.\n\n### Bootstrapping\n\nBefore using Polaris when using a metastore manager other than `in-memory`, you must **bootstrap** the metastore manager. This is a manual operation that must be performed **only once** in order to prepare the metastore manager to integrate with Polaris. When the metastore manager is bootstrapped, any existing Polaris entities in the metastore manager may be **purged**.\n\nTo bootstrap Polaris, run:\n\n```bash\njava -jar /path/to/jar/polaris-service-all.jar bootstrap polaris-server.yml\n```\n\nAfterwards, Polaris can be launched normally:\n\n```bash\njava -jar /path/to/jar/polaris-service-all.jar server polaris-server.yml\n```\n\n## Other Configurations\n\nWhen deploying Polaris in production, consider adjusting the following configurations:\n\n#### featureConfiguration.SUPPORTED_CATALOG_STORAGE_TYPES\n  - By default Polaris catalogs are allowed to be located in local filesystem with the `FILE` storage type. This should be disabled for production systems.\n  - Use this configuration to additionally disable any other storage types that will not be in use.\n\n\n","x-displayName":"Configuring Polaris for Production"},{"name":"polaris-management-service_other","x-displayName":"other"},{"name":"Configuration API","x-displayName":"Configuration API"},{"name":"OAuth2 API","x-displayName":"OAuth2 API"},{"name":"Catalog API","x-displayName":"Catalog API"}],"paths":{"/catalogs":{"get":{"operationId":"listCatalogs","description":"List all catalogs in this polaris service","responses":{"200":{"description":"List of catalogs in the polaris service","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_Catalogs"}}}},"403":{"description":"The caller does not have permission to list catalog details"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]},"post":{"operationId":"createCatalog","description":"Add a new Catalog","requestBody":{"description":"The Catalog to create","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_CreateCatalogRequest"}}}},"responses":{"201":{"description":"Successful response"},"403":{"description":"The caller does not have permission to create a catalog"},"404":{"description":"The catalog does not exist"},"409":{"description":"A catalog with the specified name already exists"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]}},"/catalogs/{catalogName}":{"parameters":[{"name":"catalogName","in":"path","description":"The name of the catalog","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"}}],"get":{"operationId":"getCatalog","description":"Get the details of a catalog","responses":{"200":{"description":"The catalog details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_Catalog"}}}},"403":{"description":"The caller does not have permission to read catalog details"},"404":{"description":"The catalog does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]},"put":{"operationId":"updateCatalog","description":"Update an existing catalog","requestBody":{"description":"The catalog details to use in the update","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_UpdateCatalogRequest"}}}},"responses":{"200":{"description":"The catalog details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_Catalog"}}}},"403":{"description":"The caller does not have permission to update catalog details"},"404":{"description":"The catalog does not exist"},"409":{"description":"The entity version doesn't match the currentEntityVersion; retry after fetching latest version"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]},"delete":{"operationId":"deleteCatalog","description":"Delete an existing catalog. This is a cascading operation that deletes all metadata, including principals, roles and grants. If the catalog is an internal catalog, all tables and namespaces are dropped without purge.","responses":{"204":{"description":"Success, no content"},"403":{"description":"The caller does not have permission to delete a catalog"},"404":{"description":"The catalog does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]}},"/principals":{"get":{"operationId":"listPrincipals","description":"List the principals for the current catalog","responses":{"200":{"description":"List of principals for this catalog","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_Principals"}}}},"403":{"description":"The caller does not have permission to list catalog admins"},"404":{"description":"The catalog does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]},"post":{"operationId":"createPrincipal","description":"Create a principal","requestBody":{"description":"The principal to create","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_CreatePrincipalRequest"}}}},"responses":{"201":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_PrincipalWithCredentials"}}}},"403":{"description":"The caller does not have permission to add a principal"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]}},"/principals/{principalName}":{"parameters":[{"name":"principalName","in":"path","description":"The principal name","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"}}],"get":{"operationId":"getPrincipal","description":"Get the principal details","responses":{"200":{"description":"The requested principal","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_Principal"}}}},"403":{"description":"The caller does not have permission to get principal details"},"404":{"description":"The catalog or principal does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]},"put":{"operationId":"updatePrincipal","description":"Update an existing principal","requestBody":{"description":"The principal details to use in the update","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_UpdatePrincipalRequest"}}}},"responses":{"200":{"description":"The updated principal","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_Principal"}}}},"403":{"description":"The caller does not have permission to update principal details"},"404":{"description":"The principal does not exist"},"409":{"description":"The entity version doesn't match the currentEntityVersion; retry after fetching latest version"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]},"delete":{"operationId":"deletePrincipal","description":"Remove a principal from polaris","responses":{"204":{"description":"Success, no content"},"403":{"description":"The caller does not have permission to delete a principal"},"404":{"description":"The principal does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]}},"/principals/{principalName}/rotate":{"parameters":[{"name":"principalName","in":"path","description":"The user name","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"}}],"post":{"operationId":"rotateCredentials","description":"Rotate a principal's credentials. The new credentials will be returned in the response. This is the only API, aside from createPrincipal, that returns the user's credentials. This API is *not* idempotent.","responses":{"200":{"description":"The principal details along with the newly rotated credentials","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_PrincipalWithCredentials"}}}},"403":{"description":"The caller does not have permission to rotate credentials"},"404":{"description":"The principal does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]}},"/principals/{principalName}/principal-roles":{"parameters":[{"name":"principalName","in":"path","description":"The name of the target principal","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"}}],"get":{"operationId":"listPrincipalRolesAssigned","description":"List the roles assigned to the principal","responses":{"200":{"description":"List of roles assigned to this principal","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_PrincipalRoles"}}}},"403":{"description":"The caller does not have permission to list roles"},"404":{"description":"The principal or catalog does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]},"put":{"operationId":"assignPrincipalRole","description":"Add a role to the principal","requestBody":{"description":"The principal role to assign","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_GrantPrincipalRoleRequest"}}}},"responses":{"201":{"description":"Successful response"},"403":{"description":"The caller does not have permission to add assign a role to the principal"},"404":{"description":"The catalog, the principal, or the role does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]}},"/principals/{principalName}/principal-roles/{principalRoleName}":{"parameters":[{"name":"principalName","in":"path","description":"The name of the target principal","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"}},{"name":"principalRoleName","in":"path","description":"The name of the role","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"}}],"delete":{"operationId":"revokePrincipalRole","description":"Remove a role from a catalog principal","responses":{"204":{"description":"Success, no content"},"403":{"description":"The caller does not have permission to remove a role from the principal"},"404":{"description":"The catalog or principal does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]}},"/principal-roles":{"get":{"operationId":"listPrincipalRoles","description":"List the principal roles","responses":{"200":{"description":"List of principal roles","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_PrincipalRoles"}}}},"403":{"description":"The caller does not have permission to list principal roles"},"404":{"description":"The catalog does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]},"post":{"operationId":"createPrincipalRole","description":"Create a principal role","requestBody":{"description":"The principal to create","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_CreatePrincipalRoleRequest"}}}},"responses":{"201":{"description":"Successful response"},"403":{"description":"The caller does not have permission to add a principal role"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]}},"/principal-roles/{principalRoleName}":{"parameters":[{"name":"principalRoleName","in":"path","description":"The principal role name","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"}}],"get":{"operationId":"getPrincipalRole","description":"Get the principal role details","responses":{"200":{"description":"The requested principal role","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_PrincipalRole"}}}},"403":{"description":"The caller does not have permission to get principal role details"},"404":{"description":"The principal role does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]},"put":{"operationId":"updatePrincipalRole","description":"Update an existing principalRole","requestBody":{"description":"The principalRole details to use in the update","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_UpdatePrincipalRoleRequest"}}}},"responses":{"200":{"description":"The updated principal role","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_PrincipalRole"}}}},"403":{"description":"The caller does not have permission to update principal role details"},"404":{"description":"The principal role does not exist"},"409":{"description":"The entity version doesn't match the currentEntityVersion; retry after fetching latest version"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]},"delete":{"operationId":"deletePrincipalRole","description":"Remove a principal role from polaris","responses":{"204":{"description":"Success, no content"},"403":{"description":"The caller does not have permission to delete a principal role"},"404":{"description":"The principal role does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]}},"/principal-roles/{principalRoleName}/principals":{"parameters":[{"name":"principalRoleName","in":"path","description":"The principal role name","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"}}],"get":{"operationId":"listAssigneePrincipalsForPrincipalRole","description":"List the Principals to whom the target principal role has been assigned","responses":{"200":{"description":"List the Principals to whom the target principal role has been assigned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_Principals"}}}},"403":{"description":"The caller does not have permission to list principals"},"404":{"description":"The principal role does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]}},"/principal-roles/{principalRoleName}/catalog-roles/{catalogName}":{"parameters":[{"name":"principalRoleName","in":"path","description":"The principal role name","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"}},{"name":"catalogName","in":"path","required":true,"description":"The name of the catalog where the catalogRoles reside","schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"}}],"get":{"operationId":"listCatalogRolesForPrincipalRole","description":"Get the catalog roles mapped to the principal role","responses":{"200":{"description":"The list of catalog roles mapped to the principal role","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_CatalogRoles"}}}},"403":{"description":"The caller does not have permission to list catalog roles"},"404":{"description":"The principal role does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]},"put":{"operationId":"assignCatalogRoleToPrincipalRole","description":"Assign a catalog role to a principal role","requestBody":{"description":"The principal to create","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_GrantCatalogRoleRequest"}}}},"responses":{"201":{"description":"Successful response"},"403":{"description":"The caller does not have permission to assign a catalog role"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]}},"/principal-roles/{principalRoleName}/catalog-roles/{catalogName}/{catalogRoleName}":{"parameters":[{"name":"principalRoleName","in":"path","description":"The principal role name","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"}},{"name":"catalogName","in":"path","description":"The name of the catalog that contains the role to revoke","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"}},{"name":"catalogRoleName","in":"path","description":"The name of the catalog role that should be revoked","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"}}],"delete":{"operationId":"revokeCatalogRoleFromPrincipalRole","description":"Remove a catalog role from a principal role","responses":{"204":{"description":"Success, no content"},"403":{"description":"The caller does not have permission to revoke a catalog role"},"404":{"description":"The principal role does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]}},"/catalogs/{catalogName}/catalog-roles":{"parameters":[{"name":"catalogName","in":"path","description":"The catalog for which we are reading/updating roles","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"}}],"get":{"operationId":"listCatalogRoles","description":"List existing roles in the catalog","responses":{"200":{"description":"The list of roles that exist in this catalog","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_CatalogRoles"}}}}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]},"post":{"operationId":"createCatalogRole","description":"Create a new role in the catalog","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_CreateCatalogRoleRequest"}}}},"responses":{"201":{"description":"Successful response"},"403":{"description":"The principal is not authorized to create roles"},"404":{"description":"The catalog does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]}},"/catalogs/{catalogName}/catalog-roles/{catalogRoleName}":{"parameters":[{"name":"catalogName","in":"path","description":"The catalog for which we are retrieving roles","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"}},{"name":"catalogRoleName","in":"path","description":"The name of the role","required":true,"schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"}}],"get":{"operationId":"getCatalogRole","description":"Get the details of an existing role","responses":{"200":{"description":"The specified role details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_CatalogRole"}}}},"403":{"description":"The principal is not authorized to read role data"},"404":{"description":"The catalog or the role does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]},"put":{"operationId":"updateCatalogRole","description":"Update an existing role in the catalog","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_UpdateCatalogRoleRequest"}}}},"responses":{"200":{"description":"The specified role details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_CatalogRole"}}}},"403":{"description":"The principal is not authorized to update roles"},"404":{"description":"The catalog or the role does not exist"},"409":{"description":"The entity version doesn't match the currentEntityVersion; retry after fetching latest version"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]},"delete":{"operationId":"deleteCatalogRole","description":"Delete an existing role from the catalog. All associated grants will also be deleted","responses":{"204":{"description":"Success, no content"},"403":{"description":"The principal is not authorized to delete roles"},"404":{"description":"The catalog or the role does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]}},"/catalogs/{catalogName}/catalog-roles/{catalogRoleName}/principal-roles":{"parameters":[{"name":"catalogName","in":"path","required":true,"description":"The name of the catalog where the catalog role resides","schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"}},{"name":"catalogRoleName","in":"path","required":true,"description":"The name of the catalog role","schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"}}],"get":{"operationId":"listAssigneePrincipalRolesForCatalogRole","description":"List the PrincipalRoles to which the target catalog role has been assigned","responses":{"200":{"description":"List the PrincipalRoles to which the target catalog role has been assigned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_PrincipalRoles"}}}},"403":{"description":"The caller does not have permission to list principal roles"},"404":{"description":"The catalog or catalog role does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]}},"/catalogs/{catalogName}/catalog-roles/{catalogRoleName}/grants":{"parameters":[{"name":"catalogName","in":"path","required":true,"description":"The name of the catalog where the role will receive the grant","schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"}},{"name":"catalogRoleName","in":"path","required":true,"description":"The name of the role receiving the grant (must exist)","schema":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"}}],"get":{"operationId":"listGrantsForCatalogRole","description":"List the grants the catalog role holds","responses":{"200":{"description":"List of all grants given to the role in this catalog","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_GrantResources"}}}}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]},"put":{"operationId":"addGrantToCatalogRole","description":"Add a new grant to the catalog role","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_AddGrantRequest"}}}},"responses":{"201":{"description":"Successful response"},"403":{"description":"The principal is not authorized to create grants"},"404":{"description":"The catalog or the role does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]},"post":{"operationId":"revokeGrantFromCatalogRole","description":"Delete a specific grant from the role. This may be a subset or a superset of the grants the role has. In case of a subset, the role will retain the grants not specified. If the `cascade` parameter is true, grant revocation will have a cascading effect - that is, if a principal has specific grants on a subresource, and grants are revoked on a parent resource, the grants present on the subresource will be revoked as well. By default, this behavior is disabled and grant revocation only affects the specified resource.","parameters":[{"name":"cascade","in":"query","schema":{"type":"boolean","default":false},"description":"If true, the grant revocation cascades to all subresources."}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Polaris_Management_Service_RevokeGrantRequest"}}}},"responses":{"201":{"description":"Successful response"},"403":{"description":"The principal is not authorized to create grants"},"404":{"description":"The catalog or the role does not exist"}},"tags":["polaris-management-service_other"],"security":[{"Polaris_Management_Service_OAuth2":[]}]}},"/v1/config":{"get":{"tags":["Configuration API"],"summary":"List all catalog configuration settings","operationId":"getConfig","parameters":[{"name":"warehouse","in":"query","required":false,"schema":{"type":"string"},"description":"Warehouse location or identifier to request from the service"}],"description":" All REST clients should first call this route to get catalog configuration properties from the server to configure the catalog and its HTTP client. Configuration from the server consists of two sets of key/value pairs.\n- defaults -  properties that should be used as default configuration; applied before client configuration\n- overrides - properties that should be used to override client configuration; applied after defaults and client configuration\n\nCatalog configuration is constructed by setting the defaults, then client- provided configuration, and finally overrides. The final property set is then used to configure the catalog.\n\nFor example, a default configuration property might set the size of the client pool, which can be replaced with a client-specific setting. An override might be used to set the warehouse location, which is stored on the server rather than in client configuration.\n\nCommon catalog configuration settings are documented at https://iceberg.apache.org/docs/latest/configuration/#catalog-properties ","responses":{"200":{"description":"Server specified configuration values.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_CatalogConfig"},"example":{"overrides":{"warehouse":"s3://bucket/warehouse/"},"defaults":{"clients":"4"}}}}},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]}},"/v1/oauth/tokens":{"post":{"tags":["OAuth2 API"],"summary":"Get a token using an OAuth2 flow","operationId":"getToken","description":"Exchange credentials for a token using the OAuth2 client credentials flow or token exchange.\n\nThis endpoint is used for three purposes -\n1. To exchange client credentials (client ID and secret) for an access token This uses the client credentials flow.\n2. To exchange a client token and an identity token for a more specific access token This uses the token exchange flow.\n3. To exchange an access token for one with the same claims and a refreshed expiration period This uses the token exchange flow.\n\nFor example, a catalog client may be configured with client credentials from the OAuth2 Authorization flow. This client would exchange its client ID and secret for an access token using the client credentials request with this endpoint (1). Subsequent requests would then use that access token.\n\nSome clients may also handle sessions that have additional user context. These clients would use the token exchange flow to exchange a user token (the \"subject\" token) from the session for a more specific access token for that user, using the catalog's access token as the \"actor\" token (2). The user ID token is the \"subject\" token and can be any token type allowed by the OAuth2 token exchange flow, including a unsecured JWT token with a sub claim. This request should use the catalog's bearer token in the \"Authorization\" header.\n\nClients may also use the token exchange flow to refresh a token that is about to expire by sending a token exchange request (3). The request's \"subject\" token should be the expiring token. This request should use the subject token in the \"Authorization\" header.","parameters":[{"name":"Authorization","in":"header","schema":{"type":"string"},"required":false}],"requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_OAuthTokenRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_OAuthTokenResponse"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_OAuthErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_OAuthErrorResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_OAuthErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]}},"/v1/{prefix}/namespaces":{"parameters":[{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_prefix"}],"get":{"tags":["Catalog API"],"summary":"List namespaces, optionally providing a parent namespace to list underneath","description":"List all namespaces at a certain level, optionally starting from a given parent namespace. If table accounting.tax.paid.info exists, using 'SELECT NAMESPACE IN accounting' would translate into `GET /namespaces?parent=accounting` and must return a namespace, [\"accounting\", \"tax\"] only. Using 'SELECT NAMESPACE IN accounting.tax' would translate into `GET /namespaces?parent=accounting%1Ftax` and must return a namespace, [\"accounting\", \"tax\", \"paid\"]. If `parent` is not provided, all top-level namespaces should be listed.","operationId":"listNamespaces","parameters":[{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_page-token"},{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_page-size"},{"name":"parent","in":"query","description":"An optional namespace, underneath which to list namespaces. If not provided or empty, all top-level namespaces should be listed. If parent is a multipart namespace, the parts must be separated by the unit separator (`0x1F`) byte.","required":false,"allowEmptyValue":true,"schema":{"type":"string"},"example":"accounting%1Ftax"}],"responses":{"200":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ListNamespacesResponse"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - Namespace provided in the `parent` query parameter is not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"examples":{"NoSuchNamespaceExample":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchNamespaceError"}}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]},"post":{"tags":["Catalog API"],"summary":"Create a namespace","description":"Create a namespace, with an optional set of properties. The server might also add properties, such as `last_modified_time` etc.","operationId":"createNamespace","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_CreateNamespaceRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_CreateNamespaceResponse"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"406":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnsupportedOperationResponse"},"409":{"description":"Conflict - The namespace already exists","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"examples":{"NamespaceAlreadyExists":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NamespaceAlreadyExistsError"}}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]}},"/v1/{prefix}/namespaces/{namespace}":{"parameters":[{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_prefix"},{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_namespace"}],"get":{"tags":["Catalog API"],"summary":"Load the metadata properties for a namespace","operationId":"loadNamespaceMetadata","description":"Return all stored metadata properties for a given namespace","responses":{"200":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_GetNamespaceResponse"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - Namespace not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"examples":{"NoSuchNamespaceExample":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchNamespaceError"}}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]},"head":{"tags":["Catalog API"],"summary":"Check if a namespace exists","operationId":"namespaceExists","description":"Check if a namespace exists. The response does not contain a body.","responses":{"204":{"description":"Success, no content"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - Namespace not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"examples":{"NoSuchNamespaceExample":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchNamespaceError"}}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]},"delete":{"tags":["Catalog API"],"summary":"Drop a namespace from the catalog. Namespace must be empty.","operationId":"dropNamespace","responses":{"204":{"description":"Success, no content"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - Namespace to delete does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"examples":{"NoSuchNamespaceExample":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchNamespaceError"}}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]}},"/v1/{prefix}/namespaces/{namespace}/properties":{"parameters":[{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_prefix"},{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_namespace"}],"post":{"tags":["Catalog API"],"summary":"Set or remove properties on a namespace","operationId":"updateProperties","description":"Set and/or remove properties on a namespace. The request body specifies a list of properties to remove and a map of key value pairs to update.\nProperties that are not in the request are not modified or removed by this call.\nServer implementations are not required to support namespace properties.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_UpdateNamespacePropertiesRequest"},"examples":{"UpdateAndRemoveProperties":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_UpdateAndRemoveNamespacePropertiesRequest"}}}}},"responses":{"200":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UpdateNamespacePropertiesResponse"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - Namespace not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"examples":{"NamespaceNotFound":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchNamespaceError"}}}}},"406":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnsupportedOperationResponse"},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"422":{"description":"Unprocessable Entity - A property key was included in both `removals` and `updates`","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"examples":{"UnprocessableEntityDuplicateKey":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_UnprocessableEntityDuplicateKey"}}}}},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]}},"/v1/{prefix}/namespaces/{namespace}/tables":{"parameters":[{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_prefix"},{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_namespace"}],"get":{"tags":["Catalog API"],"summary":"List all table identifiers underneath a given namespace","description":"Return all table identifiers under this namespace","operationId":"listTables","parameters":[{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_page-token"},{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_page-size"}],"responses":{"200":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ListTablesResponse"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - The namespace specified does not exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"examples":{"NamespaceNotFound":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchNamespaceError"}}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]},"post":{"tags":["Catalog API"],"summary":"Create a table in the given namespace","description":"Create a table or start a create transaction, like atomic CTAS.\n\nIf `stage-create` is false, the table is created immediately.\n\nIf `stage-create` is true, the table is not created, but table metadata is initialized and returned. The service should prepare as needed for a commit to the table commit endpoint to complete the create transaction. The client uses the returned metadata to begin a transaction. To commit the transaction, the client sends all create and subsequent changes to the table commit route. Changes from the table create operation include changes like AddSchemaUpdate and SetCurrentSchemaUpdate that set the initial table state.","operationId":"createTable","parameters":[{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_data-access"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_CreateTableRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_CreateTableResponse"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - The namespace specified does not exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"examples":{"NamespaceNotFound":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchNamespaceError"}}}}},"409":{"description":"Conflict - The table already exists","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"examples":{"NamespaceAlreadyExists":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_TableAlreadyExistsError"}}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]}},"/v1/{prefix}/namespaces/{namespace}/register":{"parameters":[{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_prefix"},{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_namespace"}],"post":{"tags":["Catalog API"],"summary":"Register a table in the given namespace using given metadata file location","description":"Register a table using given metadata file location.","operationId":"registerTable","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_RegisterTableRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_LoadTableResponse"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - The namespace specified does not exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"examples":{"NamespaceNotFound":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchNamespaceError"}}}}},"409":{"description":"Conflict - The table already exists","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"examples":{"NamespaceAlreadyExists":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_TableAlreadyExistsError"}}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]}},"/v1/{prefix}/namespaces/{namespace}/tables/{table}":{"parameters":[{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_prefix"},{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_namespace"},{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_table"}],"get":{"tags":["Catalog API"],"summary":"Load a table from the catalog","operationId":"loadTable","description":"Load a table from the catalog.\n\nThe response contains both configuration and table metadata. The configuration, if non-empty is used as additional configuration for the table that overrides catalog configuration. For example, this configuration may change the FileIO implementation to be used for the table.\n\nThe response also contains the table's full metadata, matching the table metadata JSON file.\n\nThe catalog configuration may contain credentials that should be used for subsequent requests for the table. The configuration key \"token\" is used to pass an access token to be used as a bearer token for table requests. Otherwise, a token may be passed using a RFC 8693 token type as a configuration key. For example, \"urn:ietf:params:oauth:token-type:jwt=<JWT-token>\".","parameters":[{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_data-access"},{"in":"query","name":"snapshots","description":"The snapshots to return in the body of the metadata. Setting the value to `all` would return the full set of snapshots currently valid for the table. Setting the value to `refs` would load all snapshots referenced by branches or tags.\nDefault if no param is provided is `all`.","required":false,"schema":{"type":"string","enum":["all","refs"]}}],"responses":{"200":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_LoadTableResponse"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - NoSuchTableException, table to load does not exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"examples":{"TableToLoadDoesNotExist":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchTableError"}}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]},"post":{"tags":["Catalog API"],"summary":"Commit updates to a table","operationId":"updateTable","description":"Commit updates to a table.\n\nCommits have two parts, requirements and updates. Requirements are assertions that will be validated before attempting to make and commit changes. For example, `assert-ref-snapshot-id` will check that a named ref's snapshot ID has a certain value.\n\nUpdates are changes to make to table metadata. For example, after asserting that the current main ref is at the expected snapshot, a commit may add a new child snapshot and set the ref to the new snapshot id.\n\nCreate table transactions that are started by createTable with `stage-create` set to true are committed using this route. Transactions should include all changes to the table, including table initialization, like AddSchemaUpdate and SetCurrentSchemaUpdate. The `assert-create` requirement is used to ensure that the table was not created concurrently.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_CommitTableRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_CommitTableResponse"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - NoSuchTableException, table to load does not exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"examples":{"TableToUpdateDoesNotExist":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchTableError"}}}}},"409":{"description":"Conflict - CommitFailedException, one or more requirements failed. The client may retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"500":{"description":"An unknown server-side problem occurred; the commit state is unknown.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"example":{"error":{"message":"Internal Server Error","type":"CommitStateUnknownException","code":500}}}}},"502":{"description":"A gateway or proxy received an invalid response from the upstream server; the commit state is unknown.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"example":{"error":{"message":"Invalid response from the upstream server","type":"CommitStateUnknownException","code":502}}}}},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"504":{"description":"A server-side gateway timeout occurred; the commit state is unknown.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"example":{"error":{"message":"Gateway timed out during commit","type":"CommitStateUnknownException","code":504}}}}},"5XX":{"description":"A server-side problem that might not be addressable on the client.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"example":{"error":{"message":"Bad Gateway","type":"InternalServerError","code":502}}}}}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]},"delete":{"tags":["Catalog API"],"summary":"Drop a table from the catalog","operationId":"dropTable","description":"Remove a table from the catalog","parameters":[{"name":"purgeRequested","in":"query","required":false,"description":"Whether the user requested to purge the underlying table's data and metadata","schema":{"type":"boolean","default":false}}],"responses":{"204":{"description":"Success, no content"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - NoSuchTableException, Table to drop does not exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"examples":{"TableToDeleteDoesNotExist":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchTableError"}}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]},"head":{"tags":["Catalog API"],"summary":"Check if a table exists","operationId":"tableExists","description":"Check if a table exists within a given namespace. The response does not contain a body.","responses":{"204":{"description":"Success, no content"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - NoSuchTableException, Table not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"examples":{"TableToLoadDoesNotExist":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchTableError"}}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]}},"/v1/{prefix}/tables/rename":{"parameters":[{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_prefix"}],"post":{"tags":["Catalog API"],"summary":"Rename a table from its current name to a new name","description":"Rename a table from one identifier to another. It's valid to move a table across namespaces, but the server implementation is not required to support it.","operationId":"renameTable","requestBody":{"description":"Current table identifier to rename and new table identifier to rename to","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_RenameTableRequest"},"examples":{"RenameTableSameNamespace":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_RenameTableSameNamespace"}}}},"required":true},"responses":{"204":{"description":"Success, no content"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - NoSuchTableException, Table to rename does not exist - NoSuchNamespaceException, The target namespace of the new table identifier does not exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"examples":{"TableToRenameDoesNotExist":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchTableError"},"NamespaceToRenameToDoesNotExist":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchNamespaceError"}}}}},"406":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnsupportedOperationResponse"},"409":{"description":"Conflict - The target identifier to rename to already exists as a table or view","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"example":{"summary":"The requested table identifier already exists","value":{"error":{"message":"The given table already exists","type":"AlreadyExistsException","code":409}}}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]}},"/v1/{prefix}/namespaces/{namespace}/tables/{table}/metrics":{"parameters":[{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_prefix"},{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_namespace"},{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_table"}],"post":{"tags":["Catalog API"],"summary":"Send a metrics report to this endpoint to be processed by the backend","operationId":"reportMetrics","requestBody":{"description":"The request containing the metrics report to be sent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ReportMetricsRequest"}}},"required":true},"responses":{"204":{"description":"Success, no content"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - NoSuchTableException, table to load does not exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"examples":{"TableToLoadDoesNotExist":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchTableError"}}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]}},"/v1/{prefix}/namespaces/{namespace}/tables/{table}/notifications":{"parameters":[{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_prefix"},{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_namespace"},{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_table"}],"post":{"tags":["Catalog API"],"summary":"Sends a notification to the table","operationId":"sendNotification","requestBody":{"description":"The request containing the notification to be sent","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_NotificationRequest"}}},"required":true},"responses":{"204":{"description":"Success, no content"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - NoSuchTableException, table to load does not exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"examples":{"TableToLoadDoesNotExist":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchTableError"}}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]}},"/v1/{prefix}/transactions/commit":{"parameters":[{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_prefix"}],"post":{"tags":["Catalog API"],"summary":"Commit updates to multiple tables in an atomic operation","operationId":"commitTransaction","requestBody":{"description":"Commit updates to multiple tables in an atomic operation\n\nA commit for a single table consists of a table identifier with requirements and updates. Requirements are assertions that will be validated before attempting to make and commit changes. For example, `assert-ref-snapshot-id` will check that a named ref's snapshot ID has a certain value.\n\nUpdates are changes to make to table metadata. For example, after asserting that the current main ref is at the expected snapshot, a commit may add a new child snapshot and set the ref to the new snapshot id.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_CommitTransactionRequest"}}},"required":true},"responses":{"204":{"description":"Success, no content"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - NoSuchTableException, table to load does not exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"examples":{"TableToUpdateDoesNotExist":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchTableError"}}}}},"409":{"description":"Conflict - CommitFailedException, one or more requirements failed. The client may retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"500":{"description":"An unknown server-side problem occurred; the commit state is unknown.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"example":{"error":{"message":"Internal Server Error","type":"CommitStateUnknownException","code":500}}}}},"502":{"description":"A gateway or proxy received an invalid response from the upstream server; the commit state is unknown.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"example":{"error":{"message":"Invalid response from the upstream server","type":"CommitStateUnknownException","code":502}}}}},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"504":{"description":"A server-side gateway timeout occurred; the commit state is unknown.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"example":{"error":{"message":"Gateway timed out during commit","type":"CommitStateUnknownException","code":504}}}}},"5XX":{"description":"A server-side problem that might not be addressable on the client.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"example":{"error":{"message":"Bad Gateway","type":"InternalServerError","code":502}}}}}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]}},"/v1/{prefix}/namespaces/{namespace}/views":{"parameters":[{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_prefix"},{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_namespace"}],"get":{"tags":["Catalog API"],"summary":"List all view identifiers underneath a given namespace","description":"Return all view identifiers under this namespace","operationId":"listViews","parameters":[{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_page-token"},{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_page-size"}],"responses":{"200":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ListTablesResponse"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - The namespace specified does not exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ErrorModel"},"examples":{"NamespaceNotFound":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchNamespaceError"}}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]},"post":{"tags":["Catalog API"],"summary":"Create a view in the given namespace","description":"Create a view in the given namespace.","operationId":"createView","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_CreateViewRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_LoadViewResponse"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - The namespace specified does not exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ErrorModel"},"examples":{"NamespaceNotFound":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchNamespaceError"}}}}},"409":{"description":"Conflict - The view already exists","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ErrorModel"},"examples":{"NamespaceAlreadyExists":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_ViewAlreadyExistsError"}}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]}},"/v1/{prefix}/namespaces/{namespace}/views/{view}":{"parameters":[{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_prefix"},{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_namespace"},{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_view"}],"get":{"tags":["Catalog API"],"summary":"Load a view from the catalog","operationId":"loadView","description":"Load a view from the catalog.\n\nThe response contains both configuration and view metadata. The configuration, if non-empty is used as additional configuration for the view that overrides catalog configuration.\n\nThe response also contains the view's full metadata, matching the view metadata JSON file.\n\nThe catalog configuration may contain credentials that should be used for subsequent requests for the view. The configuration key \"token\" is used to pass an access token to be used as a bearer token for view requests. Otherwise, a token may be passed using a RFC 8693 token type as a configuration key. For example, \"urn:ietf:params:oauth:token-type:jwt=<JWT-token>\".","responses":{"200":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_LoadViewResponse"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - NoSuchViewException, view to load does not exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ErrorModel"},"examples":{"ViewToLoadDoesNotExist":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchViewError"}}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]},"post":{"tags":["Catalog API"],"summary":"Replace a view","operationId":"replaceView","description":"Commit updates to a view.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_CommitViewRequest"}}}},"responses":{"200":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_LoadViewResponse"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - NoSuchViewException, view to load does not exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ErrorModel"},"examples":{"ViewToUpdateDoesNotExist":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchViewError"}}}}},"409":{"description":"Conflict - CommitFailedException. The client may retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ErrorModel"}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"500":{"description":"An unknown server-side problem occurred; the commit state is unknown.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ErrorModel"},"example":{"error":{"message":"Internal Server Error","type":"CommitStateUnknownException","code":500}}}}},"502":{"description":"A gateway or proxy received an invalid response from the upstream server; the commit state is unknown.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ErrorModel"},"example":{"error":{"message":"Invalid response from the upstream server","type":"CommitStateUnknownException","code":502}}}}},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"504":{"description":"A server-side gateway timeout occurred; the commit state is unknown.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ErrorModel"},"example":{"error":{"message":"Gateway timed out during commit","type":"CommitStateUnknownException","code":504}}}}},"5XX":{"description":"A server-side problem that might not be addressable on the client.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ErrorModel"},"example":{"error":{"message":"Bad Gateway","type":"InternalServerError","code":502}}}}}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]},"delete":{"tags":["Catalog API"],"summary":"Drop a view from the catalog","operationId":"dropView","description":"Remove a view from the catalog","responses":{"204":{"description":"Success, no content"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - NoSuchViewException, view to drop does not exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ErrorModel"},"examples":{"ViewToDeleteDoesNotExist":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchViewError"}}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]},"head":{"tags":["Catalog API"],"summary":"Check if a view exists","operationId":"viewExists","description":"Check if a view exists within a given namespace. This request does not return a response body.","responses":{"204":{"description":"Success, no content"},"400":{"description":"Bad Request"},"401":{"description":"Unauthorized"},"404":{"description":"Not Found"},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]}},"/v1/{prefix}/views/rename":{"parameters":[{"$ref":"#/components/parameters/Apache_Iceberg_REST_Catalog_API_prefix"}],"post":{"tags":["Catalog API"],"summary":"Rename a view from its current name to a new name","description":"Rename a view from one identifier to another. It's valid to move a view across namespaces, but the server implementation is not required to support it.","operationId":"renameView","requestBody":{"description":"Current view identifier to rename and new view identifier to rename to","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_RenameTableRequest"},"examples":{"RenameViewSameNamespace":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_RenameViewSameNamespace"}}}},"required":true},"responses":{"204":{"description":"Success, no content"},"400":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse"},"401":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse"},"403":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ForbiddenResponse"},"404":{"description":"Not Found - NoSuchViewException, view to rename does not exist - NoSuchNamespaceException, The target namespace of the new identifier does not exist","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ErrorModel"},"examples":{"ViewToRenameDoesNotExist":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchViewError"},"NamespaceToRenameToDoesNotExist":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_NoSuchNamespaceError"}}}}},"406":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_UnsupportedOperationResponse"},"409":{"description":"Conflict - The target identifier to rename to already exists as a table or view","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ErrorModel"},"example":{"summary":"The requested view identifier already exists","value":{"error":{"message":"The given view already exists","type":"AlreadyExistsException","code":409}}}}}},"419":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse"},"503":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse"},"5XX":{"$ref":"#/components/responses/Apache_Iceberg_REST_Catalog_API_ServerErrorResponse"}},"security":[{"Apache_Iceberg_REST_Catalog_API_OAuth2":["catalog"]},{"Apache_Iceberg_REST_Catalog_API_BearerAuth":[]}]}}},"components":{"securitySchemes":{"Polaris_Management_Service_OAuth2":{"type":"oauth2","description":"Uses OAuth 2 with client credentials flow","flows":{"implicit":{"authorizationUrl":"{scheme}://{host}/api/v1/oauth/tokens","scopes":{}}}},"Apache_Iceberg_REST_Catalog_API_OAuth2":{"type":"oauth2","description":"This scheme is used for OAuth2 authorization.\n\nFor unauthorized requests, services should return an appropriate 401 or 403 response. Implementations must not return altered success (200) responses when a request is unauthenticated or unauthorized.\nIf a separate authorization server is used, substitute the tokenUrl with the full token path of the external authorization server, and use the resulting token to access the resources defined in the spec.","flows":{"clientCredentials":{"tokenUrl":"/v1/oauth/tokens","scopes":{"catalog":"Allows interacting with the Config and Catalog APIs"}}}},"Apache_Iceberg_REST_Catalog_API_BearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"Polaris_Management_Service_Catalogs":{"type":"object","description":"A list of Catalog objects","properties":{"catalogs":{"type":"array","items":{"$ref":"#/components/schemas/Polaris_Management_Service_Catalog"}}},"required":["catalogs"]},"Polaris_Management_Service_CreateCatalogRequest":{"type":"object","description":"Request to create a new catalog","properties":{"catalog":{"$ref":"#/components/schemas/Polaris_Management_Service_Catalog"}},"required":["catalog"]},"Polaris_Management_Service_Catalog":{"type":"object","description":"A catalog object. A catalog may be internal or external. Internal catalogs are managed entirely by an external catalog interface. Third party catalogs may be other Iceberg REST implementations or other services with their own proprietary APIs","properties":{"type":{"type":"string","enum":["INTERNAL","EXTERNAL"],"description":"the type of catalog - internal or external","default":"INTERNAL"},"name":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$","description":"The name of the catalog"},"properties":{"type":"object","properties":{"default-base-location":{"type":"string"}},"additionalProperties":{"type":"string"},"required":["default-base-location"]},"createTimestamp":{"type":"integer","format":"int64","description":"The creation time represented as unix epoch timestamp in milliseconds"},"lastUpdateTimestamp":{"type":"integer","format":"int64","description":"The last update time represented as unix epoch timestamp in milliseconds"},"entityVersion":{"type":"integer","description":"The version of the catalog object used to determine if the catalog metadata has changed"},"storageConfigInfo":{"$ref":"#/components/schemas/Polaris_Management_Service_StorageConfigInfo"}},"required":["name","type","storageConfigInfo","properties"],"discriminator":{"propertyName":"type","mapping":{"INTERNAL":"#/components/schemas/Polaris_Management_Service_PolarisCatalog","EXTERNAL":"#/components/schemas/Polaris_Management_Service_ExternalCatalog"}}},"Polaris_Management_Service_PolarisCatalog":{"type":"object","allOf":[{"$ref":"#/components/schemas/Polaris_Management_Service_Catalog"}],"description":"The base catalog type - this contains all the fields necessary to construct an INTERNAL catalog"},"Polaris_Management_Service_ExternalCatalog":{"description":"An externally managed catalog","type":"object","allOf":[{"$ref":"#/components/schemas/Polaris_Management_Service_Catalog"},{"type":"object","properties":{"remoteUrl":{"type":"string","description":"URL to the remote catalog API"}}}]},"Polaris_Management_Service_StorageConfigInfo":{"type":"object","description":"A storage configuration used by catalogs","properties":{"storageType":{"type":"string","enum":["S3","GCS","AZURE","FILE"],"description":"The cloud provider type this storage is built on. FILE is supported for testing purposes only"},"allowedLocations":{"type":"array","items":{"type":"string"},"example":"For AWS [s3://bucketname/prefix/], for AZURE [abfss://container@storageaccount.blob.core.windows.net/prefix/], for GCP [gs://bucketname/prefix/]"}},"required":["storageType"],"discriminator":{"propertyName":"storageType","mapping":{"S3":"#/components/schemas/Polaris_Management_Service_AwsStorageConfigInfo","AZURE":"#/components/schemas/Polaris_Management_Service_AzureStorageConfigInfo","GCS":"#/components/schemas/Polaris_Management_Service_GcpStorageConfigInfo","FILE":"#/components/schemas/Polaris_Management_Service_FileStorageConfigInfo"}}},"Polaris_Management_Service_AwsStorageConfigInfo":{"type":"object","description":"aws storage configuration info","allOf":[{"$ref":"#/components/schemas/Polaris_Management_Service_StorageConfigInfo"}],"properties":{"roleArn":{"type":"string","description":"the aws role arn that grants privileges on the S3 buckets","example":"arn:aws:iam::123456789001:principal/abc1-b-self1234"},"externalId":{"type":"string","description":"an optional external id used to establish a trust relationship with AWS in the trust policy"},"userArn":{"type":"string","description":"the aws user arn used to assume the aws role","example":"arn:aws:iam::123456789001:user/abc1-b-self1234"}},"required":["roleArn"]},"Polaris_Management_Service_AzureStorageConfigInfo":{"type":"object","description":"azure storage configuration info","allOf":[{"$ref":"#/components/schemas/Polaris_Management_Service_StorageConfigInfo"}],"properties":{"tenantId":{"type":"string","description":"the tenant id that the storage accounts belong to"},"multiTenantAppName":{"type":"string","description":"the name of the azure client application"},"consentUrl":{"type":"string","description":"URL to the Azure permissions request page"}},"required":["tenantId"]},"Polaris_Management_Service_GcpStorageConfigInfo":{"type":"object","description":"gcp storage configuration info","allOf":[{"$ref":"#/components/schemas/Polaris_Management_Service_StorageConfigInfo"}],"properties":{"gcsServiceAccount":{"type":"string","description":"a Google cloud storage service account"}}},"Polaris_Management_Service_FileStorageConfigInfo":{"type":"object","description":"gcp storage configuration info","allOf":[{"$ref":"#/components/schemas/Polaris_Management_Service_StorageConfigInfo"}]},"Polaris_Management_Service_UpdateCatalogRequest":{"description":"Updates to apply to a Catalog","type":"object","properties":{"currentEntityVersion":{"type":"integer","description":"The version of the object onto which this update is applied; if the object changed, the update will fail and the caller should retry after fetching the latest version."},"properties":{"type":"object","additionalProperties":{"type":"string"}},"storageConfigInfo":{"$ref":"#/components/schemas/Polaris_Management_Service_StorageConfigInfo"}}},"Polaris_Management_Service_Principals":{"description":"A list of Principals","type":"object","properties":{"principals":{"type":"array","items":{"$ref":"#/components/schemas/Polaris_Management_Service_Principal"}}},"required":["principals"]},"Polaris_Management_Service_PrincipalWithCredentials":{"description":"A user with its client id and secret. This type is returned when a new principal is created or when its credentials are rotated","type":"object","properties":{"principal":{"$ref":"#/components/schemas/Polaris_Management_Service_Principal"},"credentials":{"type":"object","properties":{"clientId":{"type":"string"},"clientSecret":{"type":"string","format":"password"}}}},"required":["principal","credentials"]},"Polaris_Management_Service_CreatePrincipalRequest":{"type":"object","properties":{"principal":{"$ref":"#/components/schemas/Polaris_Management_Service_Principal"},"credentialRotationRequired":{"type":"boolean","description":"If true, the initial credentials can only be used to call rotateCredentials"}}},"Polaris_Management_Service_Principal":{"description":"A Polaris principal.","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$"},"clientId":{"type":"string","description":"The output-only OAuth clientId associated with this principal if applicable"},"properties":{"type":"object","additionalProperties":{"type":"string"}},"createTimestamp":{"type":"integer","format":"int64"},"lastUpdateTimestamp":{"type":"integer","format":"int64"},"entityVersion":{"type":"integer","description":"The version of the principal object used to determine if the principal metadata has changed"}},"required":["name"]},"Polaris_Management_Service_UpdatePrincipalRequest":{"description":"Updates to apply to a Principal","type":"object","properties":{"currentEntityVersion":{"type":"integer","description":"The version of the object onto which this update is applied; if the object changed, the update will fail and the caller should retry after fetching the latest version."},"properties":{"type":"object","additionalProperties":{"type":"string"}}},"required":["currentEntityVersion","properties"]},"Polaris_Management_Service_PrincipalRoles":{"type":"object","properties":{"roles":{"type":"array","items":{"$ref":"#/components/schemas/Polaris_Management_Service_PrincipalRole"}}},"required":["roles"]},"Polaris_Management_Service_GrantPrincipalRoleRequest":{"type":"object","properties":{"principalRole":{"$ref":"#/components/schemas/Polaris_Management_Service_PrincipalRole"}}},"Polaris_Management_Service_CreatePrincipalRoleRequest":{"type":"object","properties":{"principalRole":{"$ref":"#/components/schemas/Polaris_Management_Service_PrincipalRole"}}},"Polaris_Management_Service_PrincipalRole":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$","description":"The name of the role"},"properties":{"type":"object","additionalProperties":{"type":"string"}},"createTimestamp":{"type":"integer","format":"int64"},"lastUpdateTimestamp":{"type":"integer","format":"int64"},"entityVersion":{"type":"integer","description":"The version of the principal role object used to determine if the principal role metadata has changed"}},"required":["name"]},"Polaris_Management_Service_UpdatePrincipalRoleRequest":{"description":"Updates to apply to a Principal Role","type":"object","properties":{"currentEntityVersion":{"type":"integer","description":"The version of the object onto which this update is applied; if the object changed, the update will fail and the caller should retry after fetching the latest version."},"properties":{"type":"object","additionalProperties":{"type":"string"}}},"required":["currentEntityVersion","properties"]},"Polaris_Management_Service_CatalogRoles":{"type":"object","properties":{"roles":{"type":"array","items":{"$ref":"#/components/schemas/Polaris_Management_Service_CatalogRole"},"description":"The list of catalog roles"}},"required":["roles"]},"Polaris_Management_Service_GrantCatalogRoleRequest":{"type":"object","properties":{"catalogRole":{"$ref":"#/components/schemas/Polaris_Management_Service_CatalogRole"}}},"Polaris_Management_Service_CreateCatalogRoleRequest":{"type":"object","properties":{"catalogRole":{"$ref":"#/components/schemas/Polaris_Management_Service_CatalogRole"}}},"Polaris_Management_Service_CatalogRole":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":256,"pattern":"^(?!\\s*[s|S][y|Y][s|S][t|T][e|E][m|M]\\$).*$","description":"The name of the role"},"properties":{"type":"object","additionalProperties":{"type":"string"}},"createTimestamp":{"type":"integer","format":"int64"},"lastUpdateTimestamp":{"type":"integer","format":"int64"},"entityVersion":{"type":"integer","description":"The version of the catalog role object used to determine if the catalog role metadata has changed"}},"required":["name"]},"Polaris_Management_Service_UpdateCatalogRoleRequest":{"description":"Updates to apply to a Catalog Role","type":"object","properties":{"currentEntityVersion":{"type":"integer","description":"The version of the object onto which this update is applied; if the object changed, the update will fail and the caller should retry after fetching the latest version."},"properties":{"type":"object","additionalProperties":{"type":"string"}}},"required":["currentEntityVersion","properties"]},"Polaris_Management_Service_ViewPrivilege":{"type":"string","enum":["CATALOG_MANAGE_ACCESS","VIEW_CREATE","VIEW_DROP","VIEW_LIST","VIEW_READ_PROPERTIES","VIEW_WRITE_PROPERTIES","VIEW_FULL_METADATA"]},"Polaris_Management_Service_TablePrivilege":{"type":"string","enum":["CATALOG_MANAGE_ACCESS","TABLE_DROP","TABLE_LIST","TABLE_READ_PROPERTIES","VIEW_READ_PROPERTIES","TABLE_WRITE_PROPERTIES","TABLE_READ_DATA","TABLE_WRITE_DATA","TABLE_FULL_METADATA"]},"Polaris_Management_Service_NamespacePrivilege":{"type":"string","enum":["CATALOG_MANAGE_ACCESS","CATALOG_MANAGE_CONTENT","CATALOG_MANAGE_METADATA","NAMESPACE_CREATE","TABLE_CREATE","VIEW_CREATE","NAMESPACE_DROP","TABLE_DROP","VIEW_DROP","NAMESPACE_LIST","TABLE_LIST","VIEW_LIST","NAMESPACE_READ_PROPERTIES","TABLE_READ_PROPERTIES","VIEW_READ_PROPERTIES","NAMESPACE_WRITE_PROPERTIES","TABLE_WRITE_PROPERTIES","VIEW_WRITE_PROPERTIES","TABLE_READ_DATA","TABLE_WRITE_DATA","NAMESPACE_FULL_METADATA","TABLE_FULL_METADATA","VIEW_FULL_METADATA"]},"Polaris_Management_Service_CatalogPrivilege":{"type":"string","enum":["CATALOG_MANAGE_ACCESS","CATALOG_MANAGE_CONTENT","CATALOG_MANAGE_METADATA","CATALOG_READ_PROPERTIES","CATALOG_WRITE_PROPERTIES","NAMESPACE_CREATE","TABLE_CREATE","VIEW_CREATE","NAMESPACE_DROP","TABLE_DROP","VIEW_DROP","NAMESPACE_LIST","TABLE_LIST","VIEW_LIST","NAMESPACE_READ_PROPERTIES","TABLE_READ_PROPERTIES","VIEW_READ_PROPERTIES","NAMESPACE_WRITE_PROPERTIES","TABLE_WRITE_PROPERTIES","VIEW_WRITE_PROPERTIES","TABLE_READ_DATA","TABLE_WRITE_DATA","NAMESPACE_FULL_METADATA","TABLE_FULL_METADATA","VIEW_FULL_METADATA"]},"Polaris_Management_Service_AddGrantRequest":{"type":"object","properties":{"grant":{"$ref":"#/components/schemas/Polaris_Management_Service_GrantResource"}}},"Polaris_Management_Service_RevokeGrantRequest":{"type":"object","properties":{"grant":{"$ref":"#/components/schemas/Polaris_Management_Service_GrantResource"}}},"Polaris_Management_Service_ViewGrant":{"allOf":[{"$ref":"#/components/schemas/Polaris_Management_Service_GrantResource"},{"type":"object","properties":{"namespace":{"type":"array","items":{"type":"string"}},"viewName":{"type":"string","minLength":1,"maxLength":256},"privilege":{"$ref":"#/components/schemas/Polaris_Management_Service_ViewPrivilege"}},"required":["namespace","viewName","privilege"]}]},"Polaris_Management_Service_TableGrant":{"allOf":[{"$ref":"#/components/schemas/Polaris_Management_Service_GrantResource"},{"type":"object","properties":{"namespace":{"type":"array","items":{"type":"string"}},"tableName":{"type":"string","minLength":1,"maxLength":256},"privilege":{"$ref":"#/components/schemas/Polaris_Management_Service_TablePrivilege"}},"required":["namespace","tableName","privilege"]}]},"Polaris_Management_Service_NamespaceGrant":{"allOf":[{"$ref":"#/components/schemas/Polaris_Management_Service_GrantResource"},{"type":"object","properties":{"namespace":{"type":"array","items":{"type":"string"}},"privilege":{"$ref":"#/components/schemas/Polaris_Management_Service_NamespacePrivilege"}},"required":["namespace","privilege"]}]},"Polaris_Management_Service_CatalogGrant":{"allOf":[{"$ref":"#/components/schemas/Polaris_Management_Service_GrantResource"},{"type":"object","properties":{"privilege":{"$ref":"#/components/schemas/Polaris_Management_Service_CatalogPrivilege"}},"required":["privilege"]}]},"Polaris_Management_Service_GrantResource":{"type":"object","discriminator":{"propertyName":"type","mapping":{"catalog":"#/components/schemas/Polaris_Management_Service_CatalogGrant","namespace":"#/components/schemas/Polaris_Management_Service_NamespaceGrant","table":"#/components/schemas/Polaris_Management_Service_TableGrant","view":"#/components/schemas/Polaris_Management_Service_ViewGrant"}},"properties":{"type":{"type":"string","enum":["catalog","namespace","table","view"]}},"required":["type"]},"Polaris_Management_Service_GrantResources":{"type":"object","properties":{"grants":{"type":"array","items":{"$ref":"#/components/schemas/Polaris_Management_Service_GrantResource"}}},"required":["grants"]},"Apache_Iceberg_REST_Catalog_API_ErrorModel":{"type":"object","description":"JSON error payload returned in a response with further details on the error","required":["message","type","code"],"properties":{"message":{"type":"string","description":"Human-readable error message"},"type":{"type":"string","description":"Internal type definition of the error","example":"NoSuchNamespaceException"},"code":{"type":"integer","minimum":400,"maximum":600,"description":"HTTP response code","example":404},"stack":{"type":"array","items":{"type":"string"}}}},"Apache_Iceberg_REST_Catalog_API_CatalogConfig":{"type":"object","description":"Server-provided configuration for the catalog.","required":["defaults","overrides"],"properties":{"overrides":{"type":"object","additionalProperties":{"type":"string"},"description":"Properties that should be used to override client configuration; applied after defaults and client configuration."},"defaults":{"type":"object","additionalProperties":{"type":"string"},"description":"Properties that should be used as default configuration; applied before client configuration."}}},"Apache_Iceberg_REST_Catalog_API_CreateNamespaceRequest":{"type":"object","required":["namespace"],"properties":{"namespace":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Namespace"},"properties":{"type":"object","description":"Configured string to string map of properties for the namespace","example":{"owner":"Hank Bendickson"},"default":{},"additionalProperties":{"type":"string"}}}},"Apache_Iceberg_REST_Catalog_API_UpdateNamespacePropertiesRequest":{"type":"object","properties":{"removals":{"type":"array","uniqueItems":true,"items":{"type":"string"},"example":["department","access_group"]},"updates":{"type":"object","example":{"owner":"Hank Bendickson"},"additionalProperties":{"type":"string"}}}},"Apache_Iceberg_REST_Catalog_API_RenameTableRequest":{"type":"object","required":["source","destination"],"properties":{"source":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TableIdentifier"},"destination":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TableIdentifier"}}},"Apache_Iceberg_REST_Catalog_API_Namespace":{"description":"Reference to one or more levels of a namespace","type":"array","items":{"type":"string"},"example":["accounting","tax"]},"Apache_Iceberg_REST_Catalog_API_PageToken":{"description":"An opaque token that allows clients to make use of pagination for list APIs (e.g. ListTables). Clients may initiate the first paginated request by sending an empty query parameter `pageToken` to the server.\nServers that support pagination should identify the `pageToken` parameter and return a `next-page-token` in the response if there are more results available.  After the initial request, the value of `next-page-token` from each response must be used as the `pageToken` parameter value for the next request. The server must return `null` value for the `next-page-token` in the last response.\nServers that support pagination must return all results in a single response with the value of `next-page-token` set to `null` if the query parameter `pageToken` is not set in the request.\nServers that do not support pagination should ignore the `pageToken` parameter and return all results in a single response. The `next-page-token` must be omitted from the response.\nClients must interpret either `null` or missing response value of `next-page-token` as the end of the listing results.","type":"string","nullable":true},"Apache_Iceberg_REST_Catalog_API_TableIdentifier":{"type":"object","required":["namespace","name"],"properties":{"namespace":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Namespace"},"name":{"type":"string","nullable":false}}},"Apache_Iceberg_REST_Catalog_API_PrimitiveType":{"type":"string","example":["long","string","fixed[16]","decimal(10,2)"]},"Apache_Iceberg_REST_Catalog_API_StructField":{"type":"object","required":["id","name","type","required"],"properties":{"id":{"type":"integer"},"name":{"type":"string"},"type":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Type"},"required":{"type":"boolean"},"doc":{"type":"string"}}},"Apache_Iceberg_REST_Catalog_API_StructType":{"type":"object","required":["type","fields"],"properties":{"type":{"type":"string","enum":["struct"]},"fields":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_StructField"}}}},"Apache_Iceberg_REST_Catalog_API_ListType":{"type":"object","required":["type","element-id","element","element-required"],"properties":{"type":{"type":"string","enum":["list"]},"element-id":{"type":"integer"},"element":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Type"},"element-required":{"type":"boolean"}}},"Apache_Iceberg_REST_Catalog_API_MapType":{"type":"object","required":["type","key-id","key","value-id","value","value-required"],"properties":{"type":{"type":"string","enum":["map"]},"key-id":{"type":"integer"},"key":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Type"},"value-id":{"type":"integer"},"value":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Type"},"value-required":{"type":"boolean"}}},"Apache_Iceberg_REST_Catalog_API_Type":{"oneOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_PrimitiveType"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_StructType"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ListType"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_MapType"}]},"Apache_Iceberg_REST_Catalog_API_Schema":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_StructType"},{"type":"object","properties":{"schema-id":{"type":"integer","readOnly":true},"identifier-field-ids":{"type":"array","items":{"type":"integer"}}}}]},"Apache_Iceberg_REST_Catalog_API_Expression":{"oneOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AndOrExpression"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_NotExpression"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SetExpression"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_LiteralExpression"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_UnaryExpression"}]},"Apache_Iceberg_REST_Catalog_API_ExpressionType":{"type":"string","example":["eq","and","or","not","in","not-in","lt","lt-eq","gt","gt-eq","not-eq","starts-with","not-starts-with","is-null","not-null","is-nan","not-nan"]},"Apache_Iceberg_REST_Catalog_API_AndOrExpression":{"type":"object","required":["type","left","right"],"properties":{"type":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ExpressionType","enum":["and","or"]},"left":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Expression"},"right":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Expression"}}},"Apache_Iceberg_REST_Catalog_API_NotExpression":{"type":"object","required":["type","child"],"properties":{"type":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ExpressionType","enum":["not"]},"child":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Expression"}}},"Apache_Iceberg_REST_Catalog_API_UnaryExpression":{"type":"object","required":["type","term","value"],"properties":{"type":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ExpressionType","enum":["is-null","not-null","is-nan","not-nan"]},"term":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Term"},"value":{"type":"object"}}},"Apache_Iceberg_REST_Catalog_API_LiteralExpression":{"type":"object","required":["type","term","value"],"properties":{"type":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ExpressionType","enum":["lt","lt-eq","gt","gt-eq","eq","not-eq","starts-with","not-starts-with"]},"term":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Term"},"value":{"type":"object"}}},"Apache_Iceberg_REST_Catalog_API_SetExpression":{"type":"object","required":["type","term","values"],"properties":{"type":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ExpressionType","enum":["in","not-in"]},"term":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Term"},"values":{"type":"array","items":{"type":"object"}}}},"Apache_Iceberg_REST_Catalog_API_Term":{"oneOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Reference"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TransformTerm"}]},"Apache_Iceberg_REST_Catalog_API_Reference":{"type":"string","example":["column-name"]},"Apache_Iceberg_REST_Catalog_API_TransformTerm":{"type":"object","required":["type","transform","term"],"properties":{"type":{"type":"string","enum":["transform"]},"transform":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Transform"},"term":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Reference"}}},"Apache_Iceberg_REST_Catalog_API_Transform":{"type":"string","example":["identity","year","month","day","hour","bucket[256]","truncate[16]"]},"Apache_Iceberg_REST_Catalog_API_PartitionField":{"type":"object","required":["source-id","transform","name"],"properties":{"field-id":{"type":"integer"},"source-id":{"type":"integer"},"name":{"type":"string"},"transform":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Transform"}}},"Apache_Iceberg_REST_Catalog_API_PartitionSpec":{"type":"object","required":["fields"],"properties":{"spec-id":{"type":"integer","readOnly":true},"fields":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_PartitionField"}}}},"Apache_Iceberg_REST_Catalog_API_SortDirection":{"type":"string","enum":["asc","desc"]},"Apache_Iceberg_REST_Catalog_API_NullOrder":{"type":"string","enum":["nulls-first","nulls-last"]},"Apache_Iceberg_REST_Catalog_API_SortField":{"type":"object","required":["source-id","transform","direction","null-order"],"properties":{"source-id":{"type":"integer"},"transform":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Transform"},"direction":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SortDirection"},"null-order":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_NullOrder"}}},"Apache_Iceberg_REST_Catalog_API_SortOrder":{"type":"object","required":["order-id","fields"],"properties":{"order-id":{"type":"integer","readOnly":true},"fields":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SortField"}}}},"Apache_Iceberg_REST_Catalog_API_Snapshot":{"type":"object","required":["snapshot-id","timestamp-ms","manifest-list","summary"],"properties":{"snapshot-id":{"type":"integer","format":"int64"},"parent-snapshot-id":{"type":"integer","format":"int64"},"sequence-number":{"type":"integer","format":"int64"},"timestamp-ms":{"type":"integer","format":"int64"},"manifest-list":{"type":"string","description":"Location of the snapshot's manifest list file"},"summary":{"type":"object","required":["operation"],"properties":{"operation":{"type":"string","enum":["append","replace","overwrite","delete"]}},"additionalProperties":{"type":"string"}},"schema-id":{"type":"integer"}}},"Apache_Iceberg_REST_Catalog_API_SnapshotReference":{"type":"object","required":["type","snapshot-id"],"properties":{"type":{"type":"string","enum":["tag","branch"]},"snapshot-id":{"type":"integer","format":"int64"},"max-ref-age-ms":{"type":"integer","format":"int64"},"max-snapshot-age-ms":{"type":"integer","format":"int64"},"min-snapshots-to-keep":{"type":"integer"}}},"Apache_Iceberg_REST_Catalog_API_SnapshotReferences":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SnapshotReference"}},"Apache_Iceberg_REST_Catalog_API_SnapshotLog":{"type":"array","items":{"type":"object","required":["snapshot-id","timestamp-ms"],"properties":{"snapshot-id":{"type":"integer","format":"int64"},"timestamp-ms":{"type":"integer","format":"int64"}}}},"Apache_Iceberg_REST_Catalog_API_MetadataLog":{"type":"array","items":{"type":"object","required":["metadata-file","timestamp-ms"],"properties":{"metadata-file":{"type":"string"},"timestamp-ms":{"type":"integer","format":"int64"}}}},"Apache_Iceberg_REST_Catalog_API_TableMetadata":{"type":"object","required":["format-version","table-uuid"],"properties":{"format-version":{"type":"integer","minimum":1,"maximum":2},"table-uuid":{"type":"string"},"location":{"type":"string"},"last-updated-ms":{"type":"integer","format":"int64"},"properties":{"type":"object","additionalProperties":{"type":"string"}},"schemas":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Schema"}},"current-schema-id":{"type":"integer"},"last-column-id":{"type":"integer"},"partition-specs":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_PartitionSpec"}},"default-spec-id":{"type":"integer"},"last-partition-id":{"type":"integer"},"sort-orders":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SortOrder"}},"default-sort-order-id":{"type":"integer"},"snapshots":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Snapshot"}},"refs":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SnapshotReferences"},"current-snapshot-id":{"type":"integer","format":"int64"},"last-sequence-number":{"type":"integer","format":"int64"},"snapshot-log":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SnapshotLog"},"metadata-log":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_MetadataLog"},"statistics-files":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_StatisticsFile"}},"partition-statistics-files":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_PartitionStatisticsFile"}}}},"Apache_Iceberg_REST_Catalog_API_SQLViewRepresentation":{"type":"object","required":["type","sql","dialect"],"properties":{"type":{"type":"string"},"sql":{"type":"string"},"dialect":{"type":"string"}}},"Apache_Iceberg_REST_Catalog_API_ViewRepresentation":{"oneOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SQLViewRepresentation"}]},"Apache_Iceberg_REST_Catalog_API_ViewHistoryEntry":{"type":"object","required":["version-id","timestamp-ms"],"properties":{"version-id":{"type":"integer"},"timestamp-ms":{"type":"integer","format":"int64"}}},"Apache_Iceberg_REST_Catalog_API_ViewVersion":{"type":"object","required":["version-id","timestamp-ms","schema-id","summary","representations","default-namespace"],"properties":{"version-id":{"type":"integer"},"timestamp-ms":{"type":"integer","format":"int64"},"schema-id":{"type":"integer","description":"Schema ID to set as current, or -1 to set last added schema"},"summary":{"type":"object","additionalProperties":{"type":"string"}},"representations":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ViewRepresentation"}},"default-catalog":{"type":"string"},"default-namespace":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Namespace"}}},"Apache_Iceberg_REST_Catalog_API_ViewMetadata":{"type":"object","required":["view-uuid","format-version","location","current-version-id","versions","version-log","schemas"],"properties":{"view-uuid":{"type":"string"},"format-version":{"type":"integer","minimum":1,"maximum":1},"location":{"type":"string"},"current-version-id":{"type":"integer"},"versions":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ViewVersion"}},"version-log":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ViewHistoryEntry"}},"schemas":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Schema"}},"properties":{"type":"object","additionalProperties":{"type":"string"}}}},"Apache_Iceberg_REST_Catalog_API_BaseUpdate":{"discriminator":{"propertyName":"action","mapping":{"assign-uuid":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AssignUUIDUpdate","upgrade-format-version":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_UpgradeFormatVersionUpdate","add-schema":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AddSchemaUpdate","set-current-schema":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SetCurrentSchemaUpdate","add-spec":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AddPartitionSpecUpdate","set-default-spec":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SetDefaultSpecUpdate","add-sort-order":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AddSortOrderUpdate","set-default-sort-order":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SetDefaultSortOrderUpdate","add-snapshot":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AddSnapshotUpdate","set-snapshot-ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SetSnapshotRefUpdate","remove-snapshots":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_RemoveSnapshotsUpdate","remove-snapshot-ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_RemoveSnapshotRefUpdate","set-location":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SetLocationUpdate","set-properties":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SetPropertiesUpdate","remove-properties":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_RemovePropertiesUpdate","add-view-version":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AddViewVersionUpdate","set-current-view-version":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SetCurrentViewVersionUpdate","set-statistics":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SetStatisticsUpdate","remove-statistics":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_RemoveStatisticsUpdate","set-partition-statistics":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SetPartitionStatisticsUpdate","remove-partition-statistics":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_RemovePartitionStatisticsUpdate"}},"type":"object","required":["action"],"properties":{"action":{"type":"string"}}},"Apache_Iceberg_REST_Catalog_API_AssignUUIDUpdate":{"description":"Assigning a UUID to a table/view should only be done when creating the table/view. It is not safe to re-assign the UUID if a table/view already has a UUID assigned","allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"}],"required":["action","uuid"],"properties":{"action":{"type":"string","enum":["assign-uuid"]},"uuid":{"type":"string"}}},"Apache_Iceberg_REST_Catalog_API_UpgradeFormatVersionUpdate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"}],"required":["action","format-version"],"properties":{"action":{"type":"string","enum":["upgrade-format-version"]},"format-version":{"type":"integer"}}},"Apache_Iceberg_REST_Catalog_API_AddSchemaUpdate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"}],"required":["action","schema"],"properties":{"action":{"type":"string","enum":["add-schema"]},"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Schema"},"last-column-id":{"type":"integer","description":"The highest assigned column ID for the table. This is used to ensure columns are always assigned an unused ID when evolving schemas. When omitted, it will be computed on the server side."}}},"Apache_Iceberg_REST_Catalog_API_SetCurrentSchemaUpdate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"}],"required":["action","schema-id"],"properties":{"action":{"type":"string","enum":["set-current-schema"]},"schema-id":{"type":"integer","description":"Schema ID to set as current, or -1 to set last added schema"}}},"Apache_Iceberg_REST_Catalog_API_AddPartitionSpecUpdate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"}],"required":["action","spec"],"properties":{"action":{"type":"string","enum":["add-spec"]},"spec":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_PartitionSpec"}}},"Apache_Iceberg_REST_Catalog_API_SetDefaultSpecUpdate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"}],"required":["action","spec-id"],"properties":{"action":{"type":"string","enum":["set-default-spec"]},"spec-id":{"type":"integer","description":"Partition spec ID to set as the default, or -1 to set last added spec"}}},"Apache_Iceberg_REST_Catalog_API_AddSortOrderUpdate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"}],"required":["action","sort-order"],"properties":{"action":{"type":"string","enum":["add-sort-order"]},"sort-order":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SortOrder"}}},"Apache_Iceberg_REST_Catalog_API_SetDefaultSortOrderUpdate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"}],"required":["action","sort-order-id"],"properties":{"action":{"type":"string","enum":["set-default-sort-order"]},"sort-order-id":{"type":"integer","description":"Sort order ID to set as the default, or -1 to set last added sort order"}}},"Apache_Iceberg_REST_Catalog_API_AddSnapshotUpdate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"}],"required":["action","snapshot"],"properties":{"action":{"type":"string","enum":["add-snapshot"]},"snapshot":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Snapshot"}}},"Apache_Iceberg_REST_Catalog_API_SetSnapshotRefUpdate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SnapshotReference"}],"required":["action","ref-name"],"properties":{"action":{"type":"string","enum":["set-snapshot-ref"]},"ref-name":{"type":"string"}}},"Apache_Iceberg_REST_Catalog_API_RemoveSnapshotsUpdate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"}],"required":["action","snapshot-ids"],"properties":{"action":{"type":"string","enum":["remove-snapshots"]},"snapshot-ids":{"type":"array","items":{"type":"integer","format":"int64"}}}},"Apache_Iceberg_REST_Catalog_API_RemoveSnapshotRefUpdate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"}],"required":["action","ref-name"],"properties":{"action":{"type":"string","enum":["remove-snapshot-ref"]},"ref-name":{"type":"string"}}},"Apache_Iceberg_REST_Catalog_API_SetLocationUpdate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"}],"required":["action","location"],"properties":{"action":{"type":"string","enum":["set-location"]},"location":{"type":"string"}}},"Apache_Iceberg_REST_Catalog_API_SetPropertiesUpdate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"}],"required":["action","updates"],"properties":{"action":{"type":"string","enum":["set-properties"]},"updates":{"type":"object","additionalProperties":{"type":"string"}}}},"Apache_Iceberg_REST_Catalog_API_RemovePropertiesUpdate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"}],"required":["action","removals"],"properties":{"action":{"type":"string","enum":["remove-properties"]},"removals":{"type":"array","items":{"type":"string"}}}},"Apache_Iceberg_REST_Catalog_API_AddViewVersionUpdate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"}],"required":["action","view-version"],"properties":{"action":{"type":"string","enum":["add-view-version"]},"view-version":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ViewVersion"}}},"Apache_Iceberg_REST_Catalog_API_SetCurrentViewVersionUpdate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"}],"required":["action","view-version-id"],"properties":{"action":{"type":"string","enum":["set-current-view-version"]},"view-version-id":{"type":"integer","description":"The view version id to set as current, or -1 to set last added view version id"}}},"Apache_Iceberg_REST_Catalog_API_SetStatisticsUpdate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"}],"required":["action","snapshot-id","statistics"],"properties":{"action":{"type":"string","enum":["set-statistics"]},"snapshot-id":{"type":"integer","format":"int64"},"statistics":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_StatisticsFile"}}},"Apache_Iceberg_REST_Catalog_API_RemoveStatisticsUpdate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"}],"required":["action","snapshot-id"],"properties":{"action":{"type":"string","enum":["remove-statistics"]},"snapshot-id":{"type":"integer","format":"int64"}}},"Apache_Iceberg_REST_Catalog_API_SetPartitionStatisticsUpdate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"}],"required":["action","partition-statistics"],"properties":{"action":{"type":"string","enum":["set-partition-statistics"]},"partition-statistics":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_PartitionStatisticsFile"}}},"Apache_Iceberg_REST_Catalog_API_RemovePartitionStatisticsUpdate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BaseUpdate"}],"required":["action","snapshot-id"],"properties":{"action":{"type":"string","enum":["remove-partition-statistics"]},"snapshot-id":{"type":"integer","format":"int64"}}},"Apache_Iceberg_REST_Catalog_API_TableUpdate":{"anyOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AssignUUIDUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_UpgradeFormatVersionUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AddSchemaUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SetCurrentSchemaUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AddPartitionSpecUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SetDefaultSpecUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AddSortOrderUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SetDefaultSortOrderUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AddSnapshotUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SetSnapshotRefUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_RemoveSnapshotsUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_RemoveSnapshotRefUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SetLocationUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SetPropertiesUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_RemovePropertiesUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SetStatisticsUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_RemoveStatisticsUpdate"}]},"Apache_Iceberg_REST_Catalog_API_ViewUpdate":{"anyOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AssignUUIDUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_UpgradeFormatVersionUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AddSchemaUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SetLocationUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SetPropertiesUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_RemovePropertiesUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AddViewVersionUpdate"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SetCurrentViewVersionUpdate"}]},"Apache_Iceberg_REST_Catalog_API_TableRequirement":{"discriminator":{"propertyName":"type","mapping":{"assert-create":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AssertCreate","assert-table-uuid":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AssertTableUUID","assert-ref-snapshot-id":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AssertRefSnapshotId","assert-last-assigned-field-id":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AssertLastAssignedFieldId","assert-current-schema-id":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AssertCurrentSchemaId","assert-last-assigned-partition-id":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AssertLastAssignedPartitionId","assert-default-spec-id":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AssertDefaultSpecId","assert-default-sort-order-id":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AssertDefaultSortOrderId"}},"type":"object","required":["type"],"properties":{"type":{"type":"string"}}},"Apache_Iceberg_REST_Catalog_API_AssertCreate":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TableRequirement"}],"type":"object","description":"The table must not already exist; used for create transactions","required":["type"],"properties":{"type":{"type":"string","enum":["assert-create"]}}},"Apache_Iceberg_REST_Catalog_API_AssertTableUUID":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TableRequirement"}],"description":"The table UUID must match the requirement's `uuid`","required":["type","uuid"],"properties":{"type":{"type":"string","enum":["assert-table-uuid"]},"uuid":{"type":"string"}}},"Apache_Iceberg_REST_Catalog_API_AssertRefSnapshotId":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TableRequirement"}],"description":"The table branch or tag identified by the requirement's `ref` must reference the requirement's `snapshot-id`; if `snapshot-id` is `null` or missing, the ref must not already exist","required":["type","ref","snapshot-id"],"properties":{"type":{"type":"string","enum":["assert-ref-snapshot-id"]},"ref":{"type":"string"},"snapshot-id":{"type":"integer","format":"int64"}}},"Apache_Iceberg_REST_Catalog_API_AssertLastAssignedFieldId":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TableRequirement"}],"description":"The table's last assigned column id must match the requirement's `last-assigned-field-id`","required":["type","last-assigned-field-id"],"properties":{"type":{"type":"string","enum":["assert-last-assigned-field-id"]},"last-assigned-field-id":{"type":"integer"}}},"Apache_Iceberg_REST_Catalog_API_AssertCurrentSchemaId":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TableRequirement"}],"description":"The table's current schema id must match the requirement's `current-schema-id`","required":["type","current-schema-id"],"properties":{"type":{"type":"string","enum":["assert-current-schema-id"]},"current-schema-id":{"type":"integer"}}},"Apache_Iceberg_REST_Catalog_API_AssertLastAssignedPartitionId":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TableRequirement"}],"description":"The table's last assigned partition id must match the requirement's `last-assigned-partition-id`","required":["type","last-assigned-partition-id"],"properties":{"type":{"type":"string","enum":["assert-last-assigned-partition-id"]},"last-assigned-partition-id":{"type":"integer"}}},"Apache_Iceberg_REST_Catalog_API_AssertDefaultSpecId":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TableRequirement"}],"description":"The table's default spec id must match the requirement's `default-spec-id`","required":["type","default-spec-id"],"properties":{"type":{"type":"string","enum":["assert-default-spec-id"]},"default-spec-id":{"type":"integer"}}},"Apache_Iceberg_REST_Catalog_API_AssertDefaultSortOrderId":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TableRequirement"}],"description":"The table's default sort order id must match the requirement's `default-sort-order-id`","required":["type","default-sort-order-id"],"properties":{"type":{"type":"string","enum":["assert-default-sort-order-id"]},"default-sort-order-id":{"type":"integer"}}},"Apache_Iceberg_REST_Catalog_API_ViewRequirement":{"discriminator":{"propertyName":"type","mapping":{"assert-view-uuid":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_AssertViewUUID"}},"type":"object","required":["type"],"properties":{"type":{"type":"string"}}},"Apache_Iceberg_REST_Catalog_API_AssertViewUUID":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ViewRequirement"}],"description":"The view UUID must match the requirement's `uuid`","required":["type","uuid"],"properties":{"type":{"type":"string","enum":["assert-view-uuid"]},"uuid":{"type":"string"}}},"Apache_Iceberg_REST_Catalog_API_LoadTableResult":{"description":"Result used when a table is successfully loaded.\n\n\nThe table metadata JSON is returned in the `metadata` field. The corresponding file location of table metadata should be returned in the `metadata-location` field, unless the metadata is not yet committed. For example, a create transaction may return metadata that is staged but not committed.\nClients can check whether metadata has changed by comparing metadata locations after the table has been created.\n\n\nThe `config` map returns table-specific configuration for the table's resources, including its HTTP client and FileIO. For example, config may contain a specific FileIO implementation class for the table depending on its underlying storage.\n\n\nThe following configurations should be respected by clients:\n\n## General Configurations\n\n- `token`: Authorization bearer token to use for table requests if OAuth2 security is enabled \n\n## AWS Configurations\n\nThe following configurations should be respected when working with tables stored in AWS S3\n - `client.region`: region to configure client for making requests to AWS\n - `s3.access-key-id`: id for for credentials that provide access to the data in S3\n - `s3.secret-access-key`: secret for credentials that provide access to data in S3 \n - `s3.session-token`: if present, this value should be used for as the session token \n - `s3.remote-signing-enabled`: if `true` remote signing should be performed as described in the `s3-signer-open-api.yaml` specification\n","type":"object","required":["metadata"],"properties":{"metadata-location":{"type":"string","description":"May be null if the table is staged as part of a transaction"},"metadata":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TableMetadata"},"config":{"type":"object","additionalProperties":{"type":"string"}}}},"Apache_Iceberg_REST_Catalog_API_CommitTableRequest":{"type":"object","required":["requirements","updates"],"properties":{"identifier":{"description":"Table identifier to update; must be present for CommitTransactionRequest","$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TableIdentifier"},"requirements":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TableRequirement"}},"updates":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TableUpdate"}}}},"Apache_Iceberg_REST_Catalog_API_CommitViewRequest":{"type":"object","required":["updates"],"properties":{"identifier":{"description":"View identifier to update","$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TableIdentifier"},"requirements":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ViewRequirement"}},"updates":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ViewUpdate"}}}},"Apache_Iceberg_REST_Catalog_API_CommitTransactionRequest":{"type":"object","required":["table-changes"],"properties":{"table-changes":{"type":"array","items":{"description":"Table commit request; must provide an `identifier`","$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_CommitTableRequest"}}}},"Apache_Iceberg_REST_Catalog_API_CreateTableRequest":{"type":"object","required":["name","schema"],"properties":{"name":{"type":"string"},"location":{"type":"string"},"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Schema"},"partition-spec":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_PartitionSpec"},"write-order":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_SortOrder"},"stage-create":{"type":"boolean"},"properties":{"type":"object","additionalProperties":{"type":"string"}}}},"Apache_Iceberg_REST_Catalog_API_RegisterTableRequest":{"type":"object","required":["name","metadata-location"],"properties":{"name":{"type":"string"},"metadata-location":{"type":"string"}}},"Apache_Iceberg_REST_Catalog_API_CreateViewRequest":{"type":"object","required":["name","schema","view-version","properties"],"properties":{"name":{"type":"string"},"location":{"type":"string"},"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Schema"},"view-version":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ViewVersion","description":"The view version to create, will replace the schema-id sent within the view-version with the id assigned to the provided schema"},"properties":{"type":"object","additionalProperties":{"type":"string"}}}},"Apache_Iceberg_REST_Catalog_API_LoadViewResult":{"description":"Result used when a view is successfully loaded.\n\n\nThe view metadata JSON is returned in the `metadata` field. The corresponding file location of view metadata is returned in the `metadata-location` field.\nClients can check whether metadata has changed by comparing metadata locations after the view has been created.\n\nThe `config` map returns view-specific configuration for the view's resources.\n\nThe following configurations should be respected by clients:\n\n## General Configurations\n\n- `token`: Authorization bearer token to use for view requests if OAuth2 security is enabled\n","type":"object","required":["metadata-location","metadata"],"properties":{"metadata-location":{"type":"string"},"metadata":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ViewMetadata"},"config":{"type":"object","additionalProperties":{"type":"string"}}}},"Apache_Iceberg_REST_Catalog_API_TokenType":{"type":"string","enum":["urn:ietf:params:oauth:token-type:access_token","urn:ietf:params:oauth:token-type:refresh_token","urn:ietf:params:oauth:token-type:id_token","urn:ietf:params:oauth:token-type:saml1","urn:ietf:params:oauth:token-type:saml2","urn:ietf:params:oauth:token-type:jwt"],"description":"Token type identifier, from RFC 8693 Section 3\n\nSee https://datatracker.ietf.org/doc/html/rfc8693#section-3"},"Apache_Iceberg_REST_Catalog_API_OAuthClientCredentialsRequest":{"description":"OAuth2 client credentials request\n\nSee https://datatracker.ietf.org/doc/html/rfc6749#section-4.4","type":"object","required":["grant_type","client_id","client_secret"],"properties":{"grant_type":{"type":"string","enum":["client_credentials"]},"scope":{"type":"string"},"client_id":{"type":"string","description":"Client ID\n\nThis can be sent in the request body, but OAuth2 recommends sending it in a Basic Authorization header."},"client_secret":{"type":"string","description":"Client secret\n\nThis can be sent in the request body, but OAuth2 recommends sending it in a Basic Authorization header."}}},"Apache_Iceberg_REST_Catalog_API_OAuthTokenExchangeRequest":{"description":"OAuth2 token exchange request\n\nSee https://datatracker.ietf.org/doc/html/rfc8693","type":"object","required":["grant_type","subject_token","subject_token_type"],"properties":{"grant_type":{"type":"string","enum":["urn:ietf:params:oauth:grant-type:token-exchange"]},"scope":{"type":"string"},"requested_token_type":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TokenType"},"subject_token":{"type":"string","description":"Subject token for token exchange request"},"subject_token_type":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TokenType"},"actor_token":{"type":"string","description":"Actor token for token exchange request"},"actor_token_type":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TokenType"}}},"Apache_Iceberg_REST_Catalog_API_OAuthTokenRequest":{"anyOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_OAuthClientCredentialsRequest"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_OAuthTokenExchangeRequest"}]},"Apache_Iceberg_REST_Catalog_API_CounterResult":{"type":"object","required":["unit","value"],"properties":{"unit":{"type":"string"},"value":{"type":"integer","format":"int64"}}},"Apache_Iceberg_REST_Catalog_API_TimerResult":{"type":"object","required":["time-unit","count","total-duration"],"properties":{"time-unit":{"type":"string"},"count":{"type":"integer","format":"int64"},"total-duration":{"type":"integer","format":"int64"}}},"Apache_Iceberg_REST_Catalog_API_MetricResult":{"anyOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_CounterResult"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TimerResult"}]},"Apache_Iceberg_REST_Catalog_API_Metrics":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_MetricResult"},"example":{"metrics":{"total-planning-duration":{"count":1,"time-unit":"nanoseconds","total-duration":2644235116},"result-data-files":{"unit":"count","value":1},"result-delete-files":{"unit":"count","value":0},"total-data-manifests":{"unit":"count","value":1},"total-delete-manifests":{"unit":"count","value":0},"scanned-data-manifests":{"unit":"count","value":1},"skipped-data-manifests":{"unit":"count","value":0},"total-file-size-bytes":{"unit":"bytes","value":10},"total-delete-file-size-bytes":{"unit":"bytes","value":0}}}},"Apache_Iceberg_REST_Catalog_API_ReportMetricsRequest":{"anyOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ScanReport"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_CommitReport"}],"required":["report-type"],"properties":{"report-type":{"type":"string"}}},"Apache_Iceberg_REST_Catalog_API_ScanReport":{"type":"object","required":["table-name","snapshot-id","filter","schema-id","projected-field-ids","projected-field-names","metrics"],"properties":{"table-name":{"type":"string"},"snapshot-id":{"type":"integer","format":"int64"},"filter":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Expression"},"schema-id":{"type":"integer"},"projected-field-ids":{"type":"array","items":{"type":"integer"}},"projected-field-names":{"type":"array","items":{"type":"string"}},"metrics":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Metrics"},"metadata":{"type":"object","additionalProperties":{"type":"string"}}}},"Apache_Iceberg_REST_Catalog_API_CommitReport":{"type":"object","required":["table-name","snapshot-id","sequence-number","operation","metrics"],"properties":{"table-name":{"type":"string"},"snapshot-id":{"type":"integer","format":"int64"},"sequence-number":{"type":"integer","format":"int64"},"operation":{"type":"string"},"metrics":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Metrics"},"metadata":{"type":"object","additionalProperties":{"type":"string"}}}},"Apache_Iceberg_REST_Catalog_API_NotificationRequest":{"required":["notification-type"],"properties":{"notification-type":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_NotificationType"},"payload":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TableUpdateNotification"}}},"Apache_Iceberg_REST_Catalog_API_NotificationType":{"type":"string","enum":["UNKNOWN","CREATE","UPDATE","DROP"]},"Apache_Iceberg_REST_Catalog_API_TableUpdateNotification":{"type":"object","required":["table-name","timestamp","table-uuid","metadata-location"],"properties":{"table-name":{"type":"string"},"timestamp":{"type":"integer","format":"int64"},"table-uuid":{"type":"string"},"metadata-location":{"type":"string"},"metadata":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TableMetadata"}}},"Apache_Iceberg_REST_Catalog_API_OAuthError":{"type":"object","required":["error"],"properties":{"error":{"type":"string","enum":["invalid_request","invalid_client","invalid_grant","unauthorized_client","unsupported_grant_type","invalid_scope"]},"error_description":{"type":"string"},"error_uri":{"type":"string"}}},"Apache_Iceberg_REST_Catalog_API_OAuthTokenResponse":{"type":"object","required":["access_token","token_type"],"properties":{"access_token":{"type":"string","description":"The access token, for client credentials or token exchange"},"token_type":{"type":"string","enum":["bearer","mac","N_A"],"description":"Access token type for client credentials or token exchange\n\nSee https://datatracker.ietf.org/doc/html/rfc6749#section-7.1"},"expires_in":{"type":"integer","description":"Lifetime of the access token in seconds for client credentials or token exchange"},"issued_token_type":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TokenType"},"refresh_token":{"type":"string","description":"Refresh token for client credentials or token exchange"},"scope":{"type":"string","description":"Authorization scope for client credentials or token exchange"}}},"Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse":{"description":"JSON wrapper for all error responses (non-2xx)","type":"object","required":["error"],"properties":{"error":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ErrorModel"}},"additionalProperties":false,"example":{"error":{"message":"The server does not support this operation","type":"UnsupportedOperationException","code":406}}},"Apache_Iceberg_REST_Catalog_API_CreateNamespaceResponse":{"type":"object","required":["namespace"],"properties":{"namespace":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Namespace"},"properties":{"type":"object","additionalProperties":{"type":"string"},"description":"Properties stored on the namespace, if supported by the server.","example":{"owner":"Ralph","created_at":"1452120468"},"default":{}}}},"Apache_Iceberg_REST_Catalog_API_GetNamespaceResponse":{"type":"object","required":["namespace"],"properties":{"namespace":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Namespace"},"properties":{"type":"object","description":"Properties stored on the namespace, if supported by the server. If the server does not support namespace properties, it should return null for this field. If namespace properties are supported, but none are set, it should return an empty object.","additionalProperties":{"type":"string"},"example":{"owner":"Ralph","transient_lastDdlTime":"1452120468"},"default":{},"nullable":true}}},"Apache_Iceberg_REST_Catalog_API_ListTablesResponse":{"type":"object","properties":{"next-page-token":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_PageToken"},"identifiers":{"type":"array","uniqueItems":true,"items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TableIdentifier"}}}},"Apache_Iceberg_REST_Catalog_API_ListNamespacesResponse":{"type":"object","properties":{"next-page-token":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_PageToken"},"namespaces":{"type":"array","uniqueItems":true,"items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_Namespace"}}}},"Apache_Iceberg_REST_Catalog_API_UpdateNamespacePropertiesResponse":{"type":"object","required":["updated","removed"],"properties":{"updated":{"description":"List of property keys that were added or updated","type":"array","uniqueItems":true,"items":{"type":"string"}},"removed":{"description":"List of properties that were removed","type":"array","items":{"type":"string"}},"missing":{"type":"array","items":{"type":"string"},"description":"List of properties requested for removal that were not found in the namespace's properties. Represents a partial success response. Server's do not need to implement this.","nullable":true}}},"Apache_Iceberg_REST_Catalog_API_CommitTableResponse":{"type":"object","required":["metadata-location","metadata"],"properties":{"metadata-location":{"type":"string"},"metadata":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TableMetadata"}}},"Apache_Iceberg_REST_Catalog_API_StatisticsFile":{"type":"object","required":["snapshot-id","statistics-path","file-size-in-bytes","file-footer-size-in-bytes","blob-metadata"],"properties":{"snapshot-id":{"type":"integer","format":"int64"},"statistics-path":{"type":"string"},"file-size-in-bytes":{"type":"integer","format":"int64"},"file-footer-size-in-bytes":{"type":"integer","format":"int64"},"blob-metadata":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BlobMetadata"}}}},"Apache_Iceberg_REST_Catalog_API_BlobMetadata":{"type":"object","required":["type","snapshot-id","sequence-number","fields"],"properties":{"type":{"type":"string"},"snapshot-id":{"type":"integer","format":"int64"},"sequence-number":{"type":"integer","format":"int64"},"fields":{"type":"array","items":{"type":"integer"}},"properties":{"type":"object"}}},"Apache_Iceberg_REST_Catalog_API_PartitionStatisticsFile":{"type":"object","required":["snapshot-id","statistics-path","file-size-in-bytes"],"properties":{"snapshot-id":{"type":"integer","format":"int64"},"statistics-path":{"type":"string"},"file-size-in-bytes":{"type":"integer","format":"int64"}}},"Apache_Iceberg_REST_Catalog_API_BooleanTypeValue":{"type":"boolean","example":true},"Apache_Iceberg_REST_Catalog_API_IntegerTypeValue":{"type":"integer","example":42},"Apache_Iceberg_REST_Catalog_API_LongTypeValue":{"type":"integer","format":"int64","example":9223372036854776000},"Apache_Iceberg_REST_Catalog_API_FloatTypeValue":{"type":"number","format":"float","example":3.14},"Apache_Iceberg_REST_Catalog_API_DoubleTypeValue":{"type":"number","format":"double","example":123.456},"Apache_Iceberg_REST_Catalog_API_DecimalTypeValue":{"type":"string","description":"Decimal type values are serialized as strings. Decimals with a positive scale serialize as numeric plain  text, while decimals with a negative scale use scientific notation and the exponent will be equal to the  negated scale. For instance, a decimal with a positive scale is '123.4500', with zero scale is '2',  and with a negative scale is '2E+20'","example":"123.4500"},"Apache_Iceberg_REST_Catalog_API_StringTypeValue":{"type":"string","example":"hello"},"Apache_Iceberg_REST_Catalog_API_UUIDTypeValue":{"type":"string","format":"uuid","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$","maxLength":36,"minLength":36,"description":"UUID type values are serialized as a 36-character lowercase string in standard UUID format as specified  by RFC-4122","example":"eb26bdb1-a1d8-4aa6-990e-da940875492c"},"Apache_Iceberg_REST_Catalog_API_DateTypeValue":{"type":"string","format":"date","description":"Date type values follow the 'YYYY-MM-DD' ISO-8601 standard date format","example":"2007-12-03"},"Apache_Iceberg_REST_Catalog_API_TimeTypeValue":{"type":"string","description":"Time type values follow the 'HH:MM:SS.ssssss' ISO-8601 format with microsecond precision","example":"22:31:08.123456"},"Apache_Iceberg_REST_Catalog_API_TimestampTypeValue":{"type":"string","description":"Timestamp type values follow the 'YYYY-MM-DDTHH:MM:SS.ssssss' ISO-8601 format with microsecond precision","example":"2007-12-03T10:15:30.123456"},"Apache_Iceberg_REST_Catalog_API_TimestampTzTypeValue":{"type":"string","description":"TimestampTz type values follow the 'YYYY-MM-DDTHH:MM:SS.ssssss+00:00' ISO-8601 format with microsecond precision,  and a timezone offset (+00:00 for UTC)","example":"2007-12-03T10:15:30.123456+00:00"},"Apache_Iceberg_REST_Catalog_API_TimestampNanoTypeValue":{"type":"string","description":"Timestamp_ns type values follow the 'YYYY-MM-DDTHH:MM:SS.sssssssss' ISO-8601 format with nanosecond precision","example":"2007-12-03T10:15:30.123456789"},"Apache_Iceberg_REST_Catalog_API_TimestampTzNanoTypeValue":{"type":"string","description":"Timestamp_ns type values follow the 'YYYY-MM-DDTHH:MM:SS.sssssssss+00:00' ISO-8601 format with nanosecond  precision, and a timezone offset (+00:00 for UTC)","example":"2007-12-03T10:15:30.123456789+00:00"},"Apache_Iceberg_REST_Catalog_API_FixedTypeValue":{"type":"string","description":"Fixed length type values are stored and serialized as an uppercase hexadecimal string  preserving the fixed length","example":"78797A"},"Apache_Iceberg_REST_Catalog_API_BinaryTypeValue":{"type":"string","description":"Binary type values are stored and serialized as an uppercase hexadecimal string","example":"78797A"},"Apache_Iceberg_REST_Catalog_API_CountMap":{"type":"object","properties":{"keys":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IntegerTypeValue"},"description":"List of integer column ids for each corresponding value"},"values":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_LongTypeValue"},"description":"List of Long values, matched to 'keys' by index"}},"example":{"keys":[1,2],"values":[100,200]}},"Apache_Iceberg_REST_Catalog_API_ValueMap":{"type":"object","properties":{"keys":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IntegerTypeValue"},"description":"List of integer column ids for each corresponding value"},"values":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_PrimitiveTypeValue"},"description":"List of primitive type values, matched to 'keys' by index"}},"example":{"keys":[1,2],"values":[100,"test"]}},"Apache_Iceberg_REST_Catalog_API_PrimitiveTypeValue":{"oneOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BooleanTypeValue"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IntegerTypeValue"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_LongTypeValue"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_FloatTypeValue"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_DoubleTypeValue"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_DecimalTypeValue"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_StringTypeValue"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_UUIDTypeValue"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_DateTypeValue"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TimeTypeValue"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TimestampTypeValue"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TimestampTzTypeValue"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TimestampNanoTypeValue"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_TimestampTzNanoTypeValue"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_FixedTypeValue"},{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BinaryTypeValue"}]},"Apache_Iceberg_REST_Catalog_API_FileFormat":{"type":"string","enum":["avro","orc","parquet"]},"Apache_Iceberg_REST_Catalog_API_ContentFile":{"discriminator":{"propertyName":"content","mapping":{"data":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_DataFile","position-deletes":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_PositionDeleteFile","equality-deletes":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_EqualityDeleteFile"}},"type":"object","required":["spec-id","content","file-path","file-format","file-size-in-bytes","record-count"],"properties":{"content":{"type":"string"},"file-path":{"type":"string"},"file-format":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_FileFormat"},"spec-id":{"type":"integer"},"partition":{"type":"array","items":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_PrimitiveTypeValue"},"description":"A list of partition field values ordered based on the fields of the partition spec specified by the  `spec-id`","example":[1,"bar"]},"file-size-in-bytes":{"type":"integer","format":"int64","description":"Total file size in bytes"},"record-count":{"type":"integer","format":"int64","description":"Number of records in the file"},"key-metadata":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_BinaryTypeValue"}],"description":"Encryption key metadata blob"},"split-offsets":{"type":"array","items":{"type":"integer","format":"int64"},"description":"List of splittable offsets"},"sort-order-id":{"type":"integer"}}},"Apache_Iceberg_REST_Catalog_API_DataFile":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ContentFile"}],"type":"object","required":["content"],"properties":{"content":{"type":"string","enum":["data"]},"column-sizes":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_CountMap"}],"description":"Map of column id to total count, including null and NaN"},"value-counts":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_CountMap"}],"description":"Map of column id to null value count"},"null-value-counts":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_CountMap"}],"description":"Map of column id to null value count"},"nan-value-counts":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_CountMap"}],"description":"Map of column id to number of NaN values in the column"},"lower-bounds":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ValueMap"}],"description":"Map of column id to lower bound primitive type values"},"upper-bounds":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ValueMap"}],"description":"Map of column id to upper bound primitive type values"}}},"Apache_Iceberg_REST_Catalog_API_PositionDeleteFile":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ContentFile"}],"required":["content"],"properties":{"content":{"type":"string","enum":["position-deletes"]}}},"Apache_Iceberg_REST_Catalog_API_EqualityDeleteFile":{"allOf":[{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ContentFile"}],"required":["content"],"properties":{"content":{"type":"string","enum":["equality-deletes"]},"equality-ids":{"type":"array","items":{"type":"integer"},"description":"List of equality field IDs"}}}},"parameters":{"Apache_Iceberg_REST_Catalog_API_namespace":{"name":"namespace","in":"path","required":true,"description":"A namespace identifier as a single string. Multipart namespace parts should be separated by the unit separator (`0x1F`) byte.","schema":{"type":"string"},"examples":{"singlepart_namespace":{"value":"accounting"},"multipart_namespace":{"value":"accounting%1Ftax"}}},"Apache_Iceberg_REST_Catalog_API_prefix":{"name":"prefix","in":"path","schema":{"type":"string"},"required":true,"description":"An optional prefix in the path"},"Apache_Iceberg_REST_Catalog_API_table":{"name":"table","in":"path","description":"A table name","required":true,"schema":{"type":"string"},"example":"sales"},"Apache_Iceberg_REST_Catalog_API_view":{"name":"view","in":"path","description":"A view name","required":true,"schema":{"type":"string"},"example":"sales"},"Apache_Iceberg_REST_Catalog_API_data-access":{"name":"X-Iceberg-Access-Delegation","in":"header","description":"Optional signal to the server that the client supports delegated access via a comma-separated list of access mechanisms.  The server may choose to supply access via any or none of the requested mechanisms.\n\nSpecific properties and handling for `vended-credentials` is documented in the `LoadTableResult` schema section of this spec document.\n\nThe protocol and specification for `remote-signing` is documented in  the `s3-signer-open-api.yaml` OpenApi spec in the `aws` module.\n","required":false,"schema":{"type":"string","enum":["vended-credentials","remote-signing"]},"style":"simple","explode":false,"example":"vended-credentials,remote-signing"},"Apache_Iceberg_REST_Catalog_API_page-token":{"name":"pageToken","in":"query","required":false,"allowEmptyValue":true,"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_PageToken"}},"Apache_Iceberg_REST_Catalog_API_page-size":{"name":"pageSize","in":"query","description":"For servers that support pagination, this signals an upper bound of the number of results that a client will receive. For servers that do not support pagination, clients may receive results larger than the indicated `pageSize`.","required":false,"schema":{"type":"integer","minimum":1}}},"responses":{"Apache_Iceberg_REST_Catalog_API_OAuthTokenResponse":{"description":"OAuth2 token response for client credentials or token exchange","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_OAuthTokenResponse"}}}},"Apache_Iceberg_REST_Catalog_API_OAuthErrorResponse":{"description":"OAuth2 error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_OAuthError"}}}},"Apache_Iceberg_REST_Catalog_API_BadRequestErrorResponse":{"description":"Indicates a bad request error. It could be caused by an unexpected request body format or other forms of request validation failure, such as invalid json. Usually serves application/json content, although in some cases simple text/plain content might be returned by the server's middleware.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"example":{"error":{"message":"Malformed request","type":"BadRequestException","code":400}}}}},"Apache_Iceberg_REST_Catalog_API_UnauthorizedResponse":{"description":"Unauthorized. Authentication is required and has failed or has not yet been provided.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"example":{"error":{"message":"Not authorized to make this request","type":"NotAuthorizedException","code":401}}}}},"Apache_Iceberg_REST_Catalog_API_ForbiddenResponse":{"description":"Forbidden. Authenticated user does not have the necessary permissions.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"example":{"error":{"message":"Not authorized to make this request","type":"NotAuthorizedException","code":403}}}}},"Apache_Iceberg_REST_Catalog_API_UnsupportedOperationResponse":{"description":"Not Acceptable / Unsupported Operation. The server does not support this operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ErrorModel"},"example":{"error":{"message":"The server does not support this operation","type":"UnsupportedOperationException","code":406}}}}},"Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse":{"description":"JSON wrapper for all error responses (non-2xx)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"example":{"error":{"message":"The server does not support this operation","type":"UnsupportedOperationException","code":406}}}}},"Apache_Iceberg_REST_Catalog_API_CreateNamespaceResponse":{"description":"Represents a successful call to create a namespace. Returns the namespace created, as well as any properties that were stored for the namespace, including those the server might have added. Implementations are not required to support namespace properties.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_CreateNamespaceResponse"},"example":{"namespace":["accounting","tax"],"properties":{"owner":"Ralph","created_at":"1452120468"}}}}},"Apache_Iceberg_REST_Catalog_API_GetNamespaceResponse":{"description":"Returns a namespace, as well as any properties stored on the namespace if namespace properties are supported by the server.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_GetNamespaceResponse"}}}},"Apache_Iceberg_REST_Catalog_API_ListTablesResponse":{"description":"A list of table identifiers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ListTablesResponse"},"examples":{"ListTablesResponseNonEmpty":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_ListTablesNonEmptyExample"},"ListTablesResponseEmpty":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_ListTablesEmptyExample"}}}}},"Apache_Iceberg_REST_Catalog_API_ListNamespacesResponse":{"description":"A list of namespaces","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_ListNamespacesResponse"},"examples":{"NonEmptyResponse":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_ListNamespacesNonEmptyExample"},"EmptyResponse":{"$ref":"#/components/examples/Apache_Iceberg_REST_Catalog_API_ListNamespacesEmptyExample"}}}}},"Apache_Iceberg_REST_Catalog_API_AuthenticationTimeoutResponse":{"description":"Credentials have timed out. If possible, the client should refresh credentials and retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"example":{"error":{"message":"Credentials have timed out","type":"AuthenticationTimeoutException","code":419}}}}},"Apache_Iceberg_REST_Catalog_API_ServiceUnavailableResponse":{"description":"The service is not ready to handle the request. The client should wait and retry.\n\nThe service may additionally send a Retry-After header to indicate when to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"example":{"error":{"message":"Slow down","type":"SlowDownException","code":503}}}}},"Apache_Iceberg_REST_Catalog_API_ServerErrorResponse":{"description":"A server-side problem that might not be addressable from the client side. Used for server 5xx errors without more specific documentation in individual routes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_IcebergErrorResponse"},"example":{"error":{"message":"Internal Server Error","type":"InternalServerError","code":500}}}}},"Apache_Iceberg_REST_Catalog_API_UpdateNamespacePropertiesResponse":{"description":"JSON data response for a synchronous update properties request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_UpdateNamespacePropertiesResponse"},"example":{"updated":["owner"],"removed":["foo"],"missing":["bar"]}}}},"Apache_Iceberg_REST_Catalog_API_CreateTableResponse":{"description":"Table metadata result after creating a table","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_LoadTableResult"}}}},"Apache_Iceberg_REST_Catalog_API_LoadTableResponse":{"description":"Table metadata result when loading a table","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_LoadTableResult"}}}},"Apache_Iceberg_REST_Catalog_API_LoadViewResponse":{"description":"View metadata result when loading a view","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_LoadViewResult"}}}},"Apache_Iceberg_REST_Catalog_API_CommitTableResponse":{"description":"Response used when a table is successfully updated.\nThe table metadata JSON is returned in the metadata field. The corresponding file location of table metadata must be returned in the metadata-location field. Clients can check whether metadata has changed by comparing metadata locations.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Apache_Iceberg_REST_Catalog_API_CommitTableResponse"}}}}},"examples":{"Apache_Iceberg_REST_Catalog_API_ListTablesEmptyExample":{"summary":"An empty list for a namespace with no tables","value":{"identifiers":[]}},"Apache_Iceberg_REST_Catalog_API_ListNamespacesEmptyExample":{"summary":"An empty list of namespaces","value":{"namespaces":[]}},"Apache_Iceberg_REST_Catalog_API_ListNamespacesNonEmptyExample":{"summary":"A non-empty list of namespaces","value":{"namespaces":[["accounting","tax"],["accounting","credits"]]}},"Apache_Iceberg_REST_Catalog_API_ListTablesNonEmptyExample":{"summary":"A non-empty list of table identifiers","value":{"identifiers":[{"namespace":["accounting","tax"],"name":"paid"},{"namespace":["accounting","tax"],"name":"owed"}]}},"Apache_Iceberg_REST_Catalog_API_MultipartNamespaceAsPathVariable":{"summary":"A multi-part namespace, as represented in a path parameter","value":"accounting%1Ftax"},"Apache_Iceberg_REST_Catalog_API_NamespaceAsPathVariable":{"summary":"A single part namespace, as represented in a path paremeter","value":"accounting"},"Apache_Iceberg_REST_Catalog_API_NamespaceAlreadyExistsError":{"summary":"The requested namespace already exists","value":{"error":{"message":"The given namespace already exists","type":"AlreadyExistsException","code":409}}},"Apache_Iceberg_REST_Catalog_API_NoSuchTableError":{"summary":"The requested table does not exist","value":{"error":{"message":"The given table does not exist","type":"NoSuchTableException","code":404}}},"Apache_Iceberg_REST_Catalog_API_NoSuchViewError":{"summary":"The requested view does not exist","value":{"error":{"message":"The given view does not exist","type":"NoSuchViewException","code":404}}},"Apache_Iceberg_REST_Catalog_API_NoSuchNamespaceError":{"summary":"The requested namespace does not exist","value":{"error":{"message":"The given namespace does not exist","type":"NoSuchNamespaceException","code":404}}},"Apache_Iceberg_REST_Catalog_API_RenameTableSameNamespace":{"summary":"Rename a table in the same namespace","value":{"source":{"namespace":["accounting","tax"],"name":"paid"},"destination":{"namespace":["accounting","tax"],"name":"owed"}}},"Apache_Iceberg_REST_Catalog_API_RenameViewSameNamespace":{"summary":"Rename a view in the same namespace","value":{"source":{"namespace":["accounting","tax"],"name":"paid-view"},"destination":{"namespace":["accounting","tax"],"name":"owed-view"}}},"Apache_Iceberg_REST_Catalog_API_TableAlreadyExistsError":{"summary":"The requested table identifier already exists","value":{"error":{"message":"The given table already exists","type":"AlreadyExistsException","code":409}}},"Apache_Iceberg_REST_Catalog_API_ViewAlreadyExistsError":{"summary":"The requested view identifier already exists","value":{"error":{"message":"The given view already exists","type":"AlreadyExistsException","code":409}}},"Apache_Iceberg_REST_Catalog_API_UnprocessableEntityDuplicateKey":{"summary":"The request body either has the same key multiple times in what should be a map with unique keys or the request body has keys in two or more fields which should be disjoint sets.","value":{"error":{"message":"The request cannot be processed as there is a key present multiple times","type":"UnprocessableEntityException","code":422}}},"Apache_Iceberg_REST_Catalog_API_UpdateAndRemoveNamespacePropertiesRequest":{"summary":"An update namespace properties request with both properties to remove and properties to upsert.","value":{"removals":["foo","bar"],"updates":{"owner":"Raoul"}}}}},"x-tagGroups":[{"name":"Apache Polaris (Incubating) Documentation","tags":["Overview","Polaris Entities","Access Control","Configuring Polaris for Production"]},{"name":"Polaris Management Service","tags":["polaris-management-service_other"]},{"name":"Apache Iceberg REST Catalog API","tags":["Configuration API","OAuth2 API","Catalog API"]}]}},"searchIndex":{"store":["section/Quick-Start","section/Quick-Start/Prerequisites","section/Quick-Start/Deploying-Polaris","section/Quick-Start/Bootstrapping-Polaris","section/Quick-Start/Defining-a-Catalog","section/Quick-Start/Using-Iceberg-and-Polaris","tag/Overview","tag/Overview/Key-concepts","tag/Overview/Example-workflow","tag/Overview/Security-and-access-control","tag/Overview/Legal-Notices","tag/Polaris-Entities","tag/Polaris-Entities/Catalog","tag/Polaris-Entities/Namespace","tag/Polaris-Entities/Table","tag/Polaris-Entities/View","tag/Polaris-Entities/Principal","tag/Polaris-Entities/Principal-Role","tag/Polaris-Entities/Catalog-Role","tag/Polaris-Entities/Privilege","tag/Access-Control","tag/Access-Control/Securable-object","tag/Access-Control/Principal-role","tag/Access-Control/Catalog-role","tag/Access-Control/RBAC-model","tag/Access-Control/Access-control-privileges","tag/Access-Control/RBAC-example","tag/Configuring-Polaris-for-Production","tag/Configuring-Polaris-for-Production/Configuring-Apache-Polaris-(Incubating)-for-Production","tag/Configuring-Polaris-for-Production/Configuring-Apache-Polaris-(Incubating)-for-Production/Security","tag/Configuring-Polaris-for-Production/Configuring-Apache-Polaris-(Incubating)-for-Production/Metastore-Management","tag/Configuring-Polaris-for-Production/Configuring-Apache-Polaris-(Incubating)-for-Production/Other-Configurations","tag/polaris-management-service_other","tag/polaris-management-service_other/operation/listCatalogs","tag/polaris-management-service_other/operation/createCatalog","tag/polaris-management-service_other/operation/getCatalog","tag/polaris-management-service_other/operation/updateCatalog","tag/polaris-management-service_other/operation/deleteCatalog","tag/polaris-management-service_other/operation/listPrincipals","tag/polaris-management-service_other/operation/createPrincipal","tag/polaris-management-service_other/operation/getPrincipal","tag/polaris-management-service_other/operation/updatePrincipal","tag/polaris-management-service_other/operation/deletePrincipal","tag/polaris-management-service_other/operation/rotateCredentials","tag/polaris-management-service_other/operation/listPrincipalRolesAssigned","tag/polaris-management-service_other/operation/assignPrincipalRole","tag/polaris-management-service_other/operation/revokePrincipalRole","tag/polaris-management-service_other/operation/listPrincipalRoles","tag/polaris-management-service_other/operation/createPrincipalRole","tag/polaris-management-service_other/operation/getPrincipalRole","tag/polaris-management-service_other/operation/updatePrincipalRole","tag/polaris-management-service_other/operation/deletePrincipalRole","tag/polaris-management-service_other/operation/listAssigneePrincipalsForPrincipalRole","tag/polaris-management-service_other/operation/listCatalogRolesForPrincipalRole","tag/polaris-management-service_other/operation/assignCatalogRoleToPrincipalRole","tag/polaris-management-service_other/operation/revokeCatalogRoleFromPrincipalRole","tag/polaris-management-service_other/operation/listCatalogRoles","tag/polaris-management-service_other/operation/createCatalogRole","tag/polaris-management-service_other/operation/getCatalogRole","tag/polaris-management-service_other/operation/updateCatalogRole","tag/polaris-management-service_other/operation/deleteCatalogRole","tag/polaris-management-service_other/operation/listAssigneePrincipalRolesForCatalogRole","tag/polaris-management-service_other/operation/listGrantsForCatalogRole","tag/polaris-management-service_other/operation/addGrantToCatalogRole","tag/polaris-management-service_other/operation/revokeGrantFromCatalogRole","tag/Configuration-API","tag/Configuration-API/operation/getConfig","tag/OAuth2-API","tag/OAuth2-API/operation/getToken","tag/Catalog-API","tag/Catalog-API/operation/listNamespaces","tag/Catalog-API/operation/createNamespace","tag/Catalog-API/operation/loadNamespaceMetadata","tag/Catalog-API/operation/namespaceExists","tag/Catalog-API/operation/dropNamespace","tag/Catalog-API/operation/updateProperties","tag/Catalog-API/operation/listTables","tag/Catalog-API/operation/createTable","tag/Catalog-API/operation/registerTable","tag/Catalog-API/operation/loadTable","tag/Catalog-API/operation/updateTable","tag/Catalog-API/operation/dropTable","tag/Catalog-API/operation/tableExists","tag/Catalog-API/operation/renameTable","tag/Catalog-API/operation/reportMetrics","tag/Catalog-API/operation/sendNotification","tag/Catalog-API/operation/commitTransaction","tag/Catalog-API/operation/listViews","tag/Catalog-API/operation/createView","tag/Catalog-API/operation/loadView","tag/Catalog-API/operation/replaceView","tag/Catalog-API/operation/dropView","tag/Catalog-API/operation/viewExists","tag/Catalog-API/operation/renameView"],"index":{"version":"2.3.9","fields":["title","description"],"fieldVectors":[["title/0",[0,4.358,1,2.667]],["description/0",[2,4.352,3,5.469,4,5.469,5,4.352,6,3.036,7,2.23,8,2.23,9,2.886,10,1.534,11,3.182,12,4.352,13,4.352,14,3.182,15,3.347,16,4.352,17,2.784,18,2.157,19,1.374,20,3.756]],["title/1",[21,4.715]],["description/1",[1,1.201,2,2.57,8,0.8,9,1.737,10,1.438,13,3.275,14,2.395,15,1.976,18,1.274,19,1.631,21,3.609,22,1.962,23,2.374,24,3.229,25,1.442,26,1.962,27,1.561,28,2.832,29,1.201,30,1.962,31,2.519,32,2.832,33,1.442,34,0.8,35,1.442,36,2.259,37,1.962,38,1.962,39,4.116,40,3.084,41,4.974,42,1.962,43,3.229,44,6.685,45,5.997,46,4.77,47,3.896,48,5.274,49,1.962,50,3.796,51,1.962,52,4.183,53,4.116,54,1.442,55,1.561,56,1.962,57,1.962,58,1.268,59,2.832,60,1.089,61,2.832,62,1.962,63,1.962,64,2.57,65,1.72,66,1.962,67,3.229,68,3.275,69,4.116,70,1.962,71,1.962,72,1.201,73,2.088,74,0.622,75,4.77,76,3.229,77,1.268,78,1.962,79,1.792,80,1.72,81,2.088,82,1.041,83,1.041,84,0.923,85,1.561,86,1.561,87,1.442,88,4.197,89,1.962,90,1.962,91,1.141,92,1.962,93,1.72,94,1.72,95,1.962,96,1.962,97,1.72]],["title/2",[10,0.896,14,2.536]],["description/2",[1,4.308,10,1.524,13,4.292,14,1.726,15,1.815,19,0.745,23,2.181,29,1.815,31,1.815,32,2.601,33,2.181,36,2.52,47,3.075,50,3.563,52,5.654,58,1.918,60,2.993,98,2.966,99,4.477,100,2.966,101,2.181,102,2.966,103,2.966,104,1.815,105,2.181,106,2.181,107,2.966,108,2.966,109,2.966,110,4.292,111,2.966,112,1.575,113,2.966,114,2.181,115,2.966,116,2.966,117,2.966,118,2.276,119,2.966,120,2.36,121,2.966,122,2.966,123,1.17,124,2.966,125,2.966,126,2.966,127,1.45,128,6.007,129,5.268,130,2.966,131,2.966,132,4.477,133,2.037,134,2.601,135,2.966,136,1.646,137,2.037]],["title/3",[10,0.896,138,3.204]],["description/3",[7,2.143,10,1.506,18,1.455,19,1.538,31,2.258,36,1.94,47,2.534,55,2.936,74,1.17,87,2.713,106,3.863,114,2.713,118,1.557,123,1.455,138,2.713,139,3.69,140,5.255,141,3.69,142,2.048,143,4.182,144,4.608,145,3.69,146,3.69,147,3.236,148,3.69,149,5.367,150,3.316,151,1.613,152,2.258,153,2.936,154,3.69,155,3.69,156,1.178,157,3.69,158,3.69,159,2.936,160,3.69,161,2.936,162,3.69,163,3.69,164,2.713,165,1.613,166,3.69,167,3.69,168,2.936,169,5.255,170,3.69,171,3.69]],["title/4",[114,3.204,172,0.584]],["description/4",[7,1.45,8,0.9,10,1.296,18,0.871,19,0.555,23,0.923,25,0.923,29,0.769,31,1.351,36,2.587,47,2.442,50,0.999,58,0.812,60,1.225,74,0.398,82,1.172,86,2.351,104,1.351,118,0.932,120,0.999,123,0.871,142,0.697,147,1.101,150,1.905,151,0.549,156,1.494,164,0.923,165,0.549,168,2.351,172,0.961,173,1.256,174,0.923,175,1.285,176,1.256,177,1.256,178,1.101,179,1.225,180,0.512,181,2.511,182,4.222,183,4.222,184,4.222,185,4.222,186,1.256,187,1.757,188,1.256,189,2.208,190,1.256,191,2.208,192,3.551,193,1.64,194,0.923,195,2.478,196,0.769,197,1.285,198,1,199,1.256,200,1.026,201,1.427,202,0.731,203,0.965,204,0.769,205,0.999,206,0.999,207,0.697,208,1.256,209,1.351,210,1.64,211,0.731,212,0.999,213,1.256,214,0.812,215,1.256,216,1.256,217,0.923,218,1.256,219,1.101,220,0.697,221,1.256,222,2.208,223,2.954,224,1.256,225,1.256,226,0.812,227,0.769,228,2.208,229,2.208,230,1.172,231,1.672,232,1.256,233,0.862,234,1.256,235,1.936,236,2.351,237,2.954,238,2.591,239,2.591,240,1.256,241,1.101,242,1.101,243,1.256,244,0.731,245,1.256,246,1.256,247,1.101,248,1.256,249,1.101,250,1.936,251,1.838,252,1.256,253,1.256,254,2.954,255,0.999,256,1.101,257,1.256,258,0.862,259,2.208,260,1.757,261,2.208,262,1.256,263,1.256,264,1.101,265,2.351,266,1.256,267,0.999,268,1.256,269,2.208,270,0.697,271,0.769,272,0.495,273,1.101]],["title/5",[10,0.649,19,0.794,36,1.002,274,1.754]],["description/5",[1,1.014,2,1.319,8,0.676,9,1.539,10,0.75,15,1.014,16,1.319,17,1.428,19,1.528,28,1.453,31,2.232,35,2.062,36,2.6,41,1.453,47,1.926,58,1.071,60,2.024,74,1.156,79,0.92,80,1.453,81,1.814,83,0.88,84,0.779,85,1.319,88,4.645,93,1.453,94,1.453,97,1.453,105,1.218,120,1.319,127,0.81,136,0.92,137,1.138,142,0.92,149,1.453,150,0.779,156,1.075,164,1.218,168,1.319,172,0.782,181,1.75,182,1.453,183,1.453,184,1.453,185,1.453,192,2.46,195,0.92,200,1.266,203,2.098,204,1.014,206,1.319,214,1.071,219,1.453,231,0.779,235,2.46,238,1.453,239,1.453,241,1.453,247,1.453,249,1.453,250,2.46,251,0.633,256,1.453,260,1.319,265,1.319,270,0.92,272,0.962,274,1.557,275,1.319,276,1.657,277,1.657,278,1.657,279,3.647,280,1.657,281,3.647,282,1.657,283,1.657,284,1.657,285,1.657,286,1.657,287,6.081,288,1.657,289,1.657,290,1.657,291,1.657,292,1.657,293,1.657,294,1.657,295,1.657,296,1.657,297,1.319,298,3.155,299,1.319,300,1.453,301,1.657,302,1.657,303,0.81,304,1.657,305,1.172,306,1.319,307,1.453,308,2.805,309,2.805,310,1.392,311,1.657,312,2.805,313,1.657,314,2.805,315,1.657,316,1.657,317,1.657,318,1.138,319,2.232,320,2.805,321,2.805,322,2.062,323,1.657,324,1.657,325,1.657,326,2.805,327,1.319,328,1.657,329,1.657,330,1.453,331,1.657,332,1.657]],["title/6",[333,4.715]],["description/6",[9,2.975,10,1.238,11,2.616,19,0.749,36,1.425,61,2.615,65,2.615,73,1.928,83,1.583,118,1.897,123,1.176,133,2.048,151,1.303,172,0.399,179,3.344,195,1.655,200,1.036,201,1.928,202,2.616,204,1.825,214,1.928,274,1.655,305,1.098,333,2.615,334,5.563,335,3.088,336,2.048,337,3.305,338,1.403,339,1.928,340,2.193,341,2.048,342,2.545,343,3.978,344,1.928,345,1.735,346,2.193,347,2.193,348,2.193,349,2.193,350,2.048,351,2.193,352,2.193,353,2.193,354,2.193,355,2.193,356,1.655,357,2.193,358,2.193,359,2.193,360,1.928,361,2.193,362,2.048,363,2.193,364,2.193,365,2.193,366,1.928,367,2.193,368,2.048,369,1.825,370,2.193,371,1.735,372,3.305,373,2.982,374,2.982,375,2.615,376,1.458,377,2.615,378,2.373,379,2.982,380,2.048,381,2.982]],["title/7",[6,2.419,382,3.468]],["description/7",[6,0.363,7,0.699,8,0.877,9,1.999,10,1.309,11,1.252,17,0.332,18,1.138,19,0.939,20,0.837,23,0.48,36,2.472,40,0.422,60,1.194,64,0.52,72,0.4,73,0.422,74,1.014,79,2.536,81,0.788,82,0.347,88,0.52,101,0.48,112,0.347,114,0.48,118,1.218,123,1.138,127,1.702,137,0.449,142,1.194,150,0.307,151,1.11,156,1.327,165,0.533,172,0.939,174,0.48,175,0.38,178,1.069,179,0.677,180,2.416,181,1.788,187,2.02,193,2.205,195,1.194,197,1.252,198,1.129,200,1.002,201,1.642,202,0.709,203,1.521,204,1.766,207,0.951,209,2.995,210,0.677,211,0.38,212,2.02,231,1.504,233,0.449,251,1.598,258,0.837,267,0.52,270,0.363,271,0.4,272,0.938,274,2.324,275,2.975,298,0.896,299,0.52,300,1.503,303,0.319,305,1.6,310,0.821,318,0.837,338,0.806,342,0.573,344,0.422,345,0.38,362,0.449,372,2.122,376,0.596,377,0.573,378,2.297,380,1.177,382,0.52,383,0.653,384,0.38,385,1.219,386,0.653,387,2.02,388,0.653,389,0.653,390,0.573,391,0.653,392,0.653,393,0.449,394,0.653,395,1.219,396,1.219,397,3.278,398,0.573,399,0.653,400,0.653,401,0.653,402,0.653,403,0.653,404,1.477,405,1.504,406,2.151,407,0.422,408,0.746,409,0.573,410,0.422,411,0.52,412,0.38,413,0.653,414,0.653,415,0.48,416,1.069,417,1.219,418,0.52,419,2.77,420,0.653,421,0.653,422,0.653,423,1.714,424,0.48,425,0.653,426,1.886,427,0.97,428,1.712,429,1.069,430,0.4,431,0.653,432,0.653,433,0.48,434,0.573,435,0.653,436,0.653,437,1.714,438,0.573,439,1.714,440,0.52,441,0.653,442,0.573,443,1.714,444,1.219,445,0.653,446,0.653,447,0.746,448,0.653,449,0.52,450,0.573,451,0.52,452,0.653,453,1.219,454,1.069,455,0.573,456,1.219,457,2.151,458,1.069,459,0.653,460,1.714,461,1.219,462,1.219,463,0.653,464,0.97,465,0.653,466,0.573,467,1.642,468,0.653,469,0.52,470,0.709,471,1.766,472,1.108,473,0.573,474,0.653,475,0.653,476,0.653,477,0.653,478,0.332,479,0.52,480,0.573,481,0.653,482,0.48,483,1.069,484,0.573,485,0.653,486,0.653,487,0.48,488,0.48,489,0.653,490,1.714,491,1.714,492,1.364,493,1.219,494,0.653,495,0.653,496,0.653,497,0.653,498,1.219,499,0.653,500,0.653,501,0.653,502,0.653]],["title/8",[18,1.719,503,3.821]],["description/8",[9,2.699,10,1.012,11,1.961,18,2.294,19,1.607,20,2.315,79,2.732,127,1.648,156,1.103,172,0.659,179,1.871,180,2.608,181,2.608,201,4.135,203,2.973,231,2.315,272,0.755,305,1.42,318,2.315,319,2.682,372,2.478,380,2.315,390,2.955,393,2.315,408,2.063,410,3.183,419,3.917,442,2.955,503,5.099,504,5.099,505,7.521,506,5.608,507,4.923,508,4.316,509,2.955,510,2.682,511,3.37,512,3.37]],["title/9",[200,1.272,376,1.791,470,2.131]],["description/9",[7,1.541,8,1.541,10,1.427,12,1.896,19,1.18,25,1.751,36,1.847,60,1.322,74,1.489,79,2.097,101,1.751,118,1.005,123,0.94,142,1.322,150,2.514,151,1.041,156,1.306,172,0.629,180,2.376,194,1.751,197,1.386,198,1.306,200,2.564,203,1.041,204,2.874,207,1.322,209,3.271,210,1.322,214,1.54,231,1.777,233,1.636,251,1.792,272,0.534,274,2.097,275,1.896,305,1.423,342,1.12,356,1.322,360,1.54,368,1.636,375,2.089,376,2.613,378,4.934,397,2.089,405,1.777,415,1.751,430,1.458,434,2.089,469,1.896,470,3.608,471,2.312,472,1.54,473,2.089,482,2.778,483,4.117,484,2.089,513,4.695,514,2.382,515,2.382,516,1.54,517,2.382,518,2.382,519,2.382,520,2.089,521,2.089,522,2.382,523,2.382,524,2.382,525,2.382,526,1.751,527,1.896]],["title/10",[341,2.993,528,4.358]],["description/10",[9,3.348,20,3.913,335,3.913,336,3.913,372,4.189,430,3.487,454,6.152,529,5.698,530,7.016,531,5.698,532,4.996,533,4.996,534,5.698]],["title/11",[7,1.777,10,0.896]],["description/11",[7,1.446,8,1.446,9,2.526,10,0.729,11,2.063,19,0.891,36,1.619,73,2.292,118,2.155,123,1.398,133,2.435,151,1.55,179,3.635,202,2.063,255,2.822,334,5.797,335,3.508,336,2.435,337,3.755,338,1.668,339,2.292,340,2.607,341,2.435,342,2.815,343,4.401,344,2.292,345,2.063,346,2.607,347,2.607,348,2.607,349,2.607,350,2.435,351,2.607,352,2.607,353,2.607,354,2.607,355,2.607,356,1.968,357,2.607,358,2.607,359,2.607,360,2.292,361,2.607,362,2.435,363,2.607,364,2.607,365,2.607,366,2.292,367,2.607,368,2.435,369,2.17,370,2.607,535,3.546,536,3.109]],["title/12",[172,0.72]],["description/12",[7,2.063,8,1.427,9,1.477,10,1.04,17,1.782,19,1.271,36,1.11,54,2.573,74,1.11,83,2.686,84,3.062,85,2.785,104,2.142,112,1.858,118,2.135,123,1.38,150,1.646,151,2.211,165,1.53,172,0.994,174,2.573,187,2.785,195,1.943,200,1.215,203,2.597,209,4.227,210,3.995,212,2.785,214,2.263,217,2.573,270,1.943,274,1.943,342,1.646,384,2.944,407,2.263,426,3.069,447,2.142,536,3.069,537,3.5,538,3.069,539,3.069,540,3.5,541,3.5,542,3.5,543,3.5,544,2.404,545,3.069,546,2.573,547,3.5,548,2.785,549,3.5]],["title/13",[272,1.205]],["description/13",[7,2.52,8,1.905,10,0.96,18,1.842,83,2.48,84,2.907,86,3.717,112,2.48,118,1.971,123,1.842,151,2.701,203,2.042,211,2.718,270,3.43,272,1.765,384,2.718,387,3.717,427,3.717,526,3.434,538,4.096,544,3.208,548,4.917,550,4.671,551,4.671,552,4.671,553,4.671,554,4.671,555,4.671,556,4.671]],["title/14",[305,1.313]],["description/14",[7,2.276,8,2.276,9,2.355,10,1.147,83,2.963,84,3.258,118,2.355,123,2.201,151,3.027,203,2.439,274,3.098,305,1.839,384,3.247,407,3.608,557,5.581,558,5.581]],["title/15",[559,2.053]],["description/15",[7,2.276,8,2.276,9,2.355,10,1.147,83,2.963,84,3.258,118,2.355,123,2.201,151,3.027,203,2.439,274,3.098,384,3.247,407,3.608,559,2.875,560,5.581,561,5.581]],["title/16",[156,1.205]],["description/16",[7,2.008,8,2.008,10,1.012,19,1.237,83,2.615,84,3.009,118,2.078,123,2.523,151,2.796,156,1.747,172,0.66,180,2.008,200,1.71,203,2.152,230,2.615,270,2.734,338,2.316,384,2.866,447,3.014,451,3.919,466,4.318,482,3.621,562,4.925,563,3.621,564,4.318,565,4.925]],["title/17",[156,0.976,198,0.976]],["description/17",[7,1.768,8,1.768,10,1.208,40,2.804,72,2.654,83,2.302,84,2.765,118,1.83,123,2.319,151,2.57,156,1.842,198,1.727,200,1.506,203,1.895,214,2.804,230,2.302,251,2.244,270,2.407,271,2.654,338,2.04,384,2.523,447,2.654,492,3.451,566,3.802,567,4.336,568,4.336,569,2.654,570,2.04,571,4.336]],["title/18",[172,0.584,198,0.976]],["description/18",[7,1.662,10,0.838,40,2.636,54,2.997,72,3.449,123,2.223,156,1.263,172,1.088,180,1.662,198,1.695,200,1.957,203,2.463,211,2.372,230,2.164,251,2.792,271,2.495,272,0.913,305,0.995,338,2.651,428,3.244,447,3.953,492,3.244,548,3.244,563,2.997,564,3.575,566,3.575,572,4.077,573,4.077,574,4.077,575,4.077]],["title/19",[231,2.529]],["description/19",[7,1.58,10,0.796,17,1.972,34,1.58,36,2.161,54,2.848,55,3.082,82,2.057,84,1.822,118,1.635,156,1.609,172,1.045,198,1.668,200,1.345,231,3.501,251,2.74,258,2.66,272,0.868,305,0.946,447,2.371,559,1.479,570,2.558,576,3.874,577,3.874,578,4.769,579,3.397,580,3.874,581,3.874,582,3.874,583,3.874,584,3.874,585,3.874,586,3.874]],["title/20",[200,1.513,470,2.536]],["description/20",[6,1.545,9,2.189,10,1.195,11,1.62,19,1.072,36,2.097,73,1.8,118,1.8,123,1.098,133,1.912,151,1.865,156,1.162,172,0.695,175,1.62,179,3.228,180,1.135,195,1.545,198,1.405,200,2.177,202,1.62,207,1.545,230,2.265,231,2.007,233,1.912,251,1.063,334,5.465,335,2.93,336,1.912,337,3.137,338,1.31,339,1.8,340,2.047,341,1.912,342,2.44,343,3.814,344,2.759,345,1.62,346,2.047,347,2.047,348,2.047,349,2.047,350,1.912,351,2.047,352,2.047,353,2.047,354,2.047,355,2.047,356,1.545,357,2.047,358,2.047,359,2.047,360,1.8,361,2.047,362,1.912,363,2.047,364,2.047,365,2.047,366,1.8,367,2.047,368,1.912,369,1.704,370,2.047,376,1.361,382,2.216,467,1.8,469,2.216,470,3.018,471,1.704,472,1.8,587,2.784]],["title/21",[175,2.536,376,2.13]],["description/21",[10,1.171,36,2.515,127,2.786,172,0.763,175,4.423,200,1.978,251,2.175,272,1.277,274,3.163,305,1.391,376,3.43,559,2.175]],["title/22",[156,0.976,198,0.976]],["description/22",[10,1.286,18,1.676,19,0.696,36,2.459,60,2.359,72,3.165,74,1.347,79,1.538,82,1.471,127,1.354,156,1.802,172,0.569,175,2.473,180,2.966,198,1.738,203,1.857,204,1.695,206,2.204,207,1.538,220,1.538,231,2.432,251,2.776,267,2.204,271,1.695,305,0.676,338,1.303,369,1.695,376,1.354,393,1.902,408,1.695,427,2.204,428,2.204,430,1.695,438,2.429,458,3.727,464,2.204,467,1.791,487,2.036,488,2.036,539,2.429,588,2.429,589,2.77,590,2.204,591,2.204,592,2.204,593,2.429,594,2.429,595,2.77]],["title/23",[172,0.584,198,0.976]],["description/23",[10,0.868,18,1.312,36,2.482,72,1.245,74,0.645,82,1.08,110,2.648,123,1.924,127,0.995,144,1.784,156,1.516,164,1.496,165,0.889,172,1.055,175,1.184,180,1.722,181,1.357,198,1.765,200,1.466,201,3.153,202,2.457,207,1.13,211,1.184,220,1.13,226,1.316,231,2.99,251,2.646,271,1.245,272,0.456,303,2.064,305,1.488,322,1.496,338,2.715,339,1.316,369,1.245,410,1.316,412,1.184,424,1.496,429,2.918,450,1.784,467,1.316,480,2.918,487,1.496,488,1.496,508,1.784,516,2.152,592,1.619,596,2.035,597,3.328,598,3.328,599,2.918,600,3.328,601,2.035,602,2.035,603,2.035,604,4.222,605,4.222,606,2.035,607,2.035,608,1.316,609,1.784]],["title/24",[471,2.667,472,2.817]],["description/24",[9,2.522,10,1.484,19,1.116,82,2.359,127,2.172,156,1.618,172,0.905,180,2.437,198,1.618,200,2.075,207,2.466,230,3.173,231,2.09,251,1.696,380,4.104,393,3.051,447,2.719,467,2.872,471,4.133,472,4.366,487,3.266,488,3.266,588,3.896,610,3.896,611,4.443]],["title/25",[200,1.272,231,1.723,470,2.131]],["description/25",[8,0.897,10,0.452,12,0.995,17,1.119,18,0.493,19,0.314,34,1.647,36,2.742,40,0.808,74,1.124,127,0.611,150,1.034,156,0.905,165,0.546,172,0.976,175,2.062,180,0.897,181,0.51,198,1.144,200,0.763,201,3.105,202,1.279,203,0.961,209,1.346,220,0.694,226,2.291,227,0.765,231,3.224,233,0.859,251,2.284,260,1.75,264,1.096,265,0.995,272,1.203,305,1.501,322,1.617,350,0.859,387,0.995,398,6.156,410,0.808,412,0.727,424,0.919,430,1.346,433,0.919,470,1.279,472,0.808,545,1.928,559,1.833,578,1.928,591,0.995,592,2.82,608,2.291,612,1.25,613,2.199,614,1.096,615,1.25,616,1.25,617,1.25,618,1.25,619,2.199,620,1.25,621,2.199,622,2.199,623,2.199,624,1.25,625,1.25,626,1.25,627,1.25,628,1.25,629,1.25,630,2.725,631,1.25,632,1.25,633,1.25,634,1.25,635,1.25,636,1.25,637,1.25,638,1.25,639,1.25,640,1.25,641,1.25,642,1.25,643,1.25,644,1.25]],["title/26",[18,1.719,471,2.667]],["description/26",[9,2.028,10,1.294,17,1.257,18,1.533,19,0.976,20,1.695,25,2.857,36,2.164,74,0.783,79,1.37,110,1.964,127,2.665,134,2.165,156,1.328,172,1.012,180,2.418,181,2.418,198,1.476,200,1.349,203,2.382,204,1.511,207,1.37,226,1.596,251,2.515,272,0.871,305,0.603,339,2.512,344,2.512,369,1.511,380,3.301,393,1.695,408,2.378,419,3.092,424,1.815,455,2.165,464,1.964,467,3.107,470,1.436,471,2.941,504,3.408,506,4.78,563,1.815,579,3.408,593,2.165,594,2.165,609,3.408,610,2.165,645,2.469,646,2.469,647,1.964,648,3.886,649,4.806,650,5.929,651,2.469,652,2.469,653,3.886,654,2.469,655,2.469]],["title/27",[10,0.753,74,1.161,152,2.242]],["description/27",[5,1.053,6,0.734,7,1.255,8,2.142,9,1.298,10,1.29,11,0.77,14,1.79,15,1.414,19,1.537,27,1.053,29,0.81,31,0.81,33,0.973,35,0.973,36,2.39,58,0.855,60,0.734,68,1.839,73,0.855,74,2.114,79,0.734,87,1.699,105,0.973,106,0.973,112,0.702,118,0.975,123,0.522,127,0.647,133,0.909,136,0.734,137,0.909,138,3.078,142,1.283,143,1.839,150,0.622,151,1.01,152,2.563,153,1.053,161,1.053,165,1.345,172,0.31,179,2.047,180,0.942,196,1.883,197,0.77,202,0.77,205,1.839,209,1.414,210,1.283,211,0.77,217,0.973,220,2.047,227,1.414,258,0.909,306,1.053,310,0.505,334,4.22,335,1.587,336,0.909,337,1.699,338,0.622,339,0.855,340,0.973,341,0.909,342,1.969,343,2.262,344,0.855,345,0.77,346,0.973,347,0.973,348,0.973,349,0.973,350,0.909,351,0.973,352,0.973,353,0.973,354,0.973,355,0.973,356,0.734,357,0.973,358,0.973,359,0.973,360,0.855,361,0.973,362,0.909,363,0.973,364,0.973,365,0.973,366,0.855,367,0.973,368,0.909,369,0.81,370,0.973,371,2.436,376,1.504,405,1.087,410,0.855,412,0.77,433,0.973,478,0.673,479,1.053,510,1.053,516,1.494,526,0.973,546,1.699,590,1.053,656,2.448,657,1.16,658,1.16,659,1.16,660,1.16,661,1.16,662,1.16,663,1.16,664,1.16,665,1.587,666,2.026,667,1.839,668,2.026,669,2.026,670,2.707,671,3.234,672,1.16,673,1.16,674,1.16,675,1.16,676,1.16,677,1.16,678,1.16,679,1.16,680,1.16,681,1.16,682,1.16,683,0.909,684,1.16,685,1.16,686,1.16,687,1.16,688,4.568,689,2.026,690,1.16,691,1.16,692,1.839,693,1.16,694,1.16,695,2.026,696,1.16,697,1.16,698,2.026,699,1.16,700,1.053,701,2.026,702,1.16,703,1.16,704,1.16,705,1.16,706,1.16,707,1.053,708,1.053,709,2.026,710,2.026,711,2.026,712,1.16,713,1.16,714,1.16,715,1.839]],["title/28",[9,1.172,10,0.571,11,1.616,74,0.881,152,1.7]],["description/28",[5,4.732,10,1.222,14,3.46,74,1.885,152,3.64,196,3.64,546,4.372,656,4.732,657,5.215,658,5.215,659,5.215,660,5.215,661,5.215,662,5.215]],["title/29",[376,2.629]],["description/29",[6,1.871,10,0.693,14,1.961,19,1.607,27,2.682,33,2.478,35,2.478,36,2.557,74,2.252,87,3.619,105,2.478,161,2.682,165,2.542,180,1.374,205,3.917,220,3.228,227,3.013,371,1.961,376,1.648,478,1.715,663,2.955,664,2.955,665,3.381,666,4.316,667,3.917,668,4.316,669,4.316,670,4.398,671,5.608,672,2.955,673,2.955,674,2.955,675,2.955,676,2.955,677,2.955,678,2.955,679,2.955,680,2.955,681,2.955,682,2.955,683,2.315,684,2.955,685,2.955,686,2.955,687,2.955]],["title/30",[8,1.777,688,3.468]],["description/30",[7,2.076,8,2.778,10,1.446,15,1.653,19,1.554,29,1.653,31,1.653,36,2.072,58,1.746,60,1.499,68,3.317,74,1.961,79,1.499,106,1.986,112,1.434,136,1.499,137,1.855,138,4.547,142,2.314,143,3.317,150,1.271,151,1.181,152,1.653,153,2.15,172,0.362,180,1.102,196,1.653,211,1.572,220,1.499,258,1.855,310,1.031,342,1.271,371,3.33,376,1.321,405,1.961,410,1.746,412,1.572,433,1.986,510,2.15,516,1.746,546,1.986,590,2.15,656,3.317,688,5.744,689,3.655,690,2.369,691,2.369,692,2.15,693,2.369,694,2.369,695,3.655,696,2.369,697,2.369,698,3.655,699,2.369,700,2.15,701,3.655,702,2.369,703,2.369,704,2.369,705,2.369,706,2.369,707,2.15,708,2.15,709,3.655,710,3.655,711,3.655,712,2.369,713,2.369]],["title/31",[74,1.705]],["description/31",[10,1.33,14,2.918,15,3.07,19,1.627,36,2.273,74,2.052,127,2.452,152,3.962,172,0.672,196,3.07,197,2.918,209,3.962,210,3.593,217,3.687,306,3.991,342,2.359,479,3.991,516,3.243,526,3.687,692,3.991,714,4.398,715,5.151]],["title/32",[]],["description/32",[]],["title/33",[716,5.377]],["description/33",[10,1.355,34,2.689,172,1.026,180,2.689]],["title/34",[717,5.377]],["description/34",[77,4.316,172,1.033,193,3.706]],["title/35",[718,5.377]],["description/35",[104,4.137,172,0.905,719,5.378]],["title/36",[720,5.377]],["description/36",[172,0.894,303,3.264,310,2.548,719,5.312]],["title/37",[721,5.377]],["description/37",[17,2.841,156,1.251,172,1.009,198,1.251,251,2.13,272,1.251,305,1.363,310,2.13,360,3.608,405,2.625,412,3.247,416,4.894,608,3.608,708,4.441,719,4.441,722,5.512,723,4.894]],["title/38",[724,5.377]],["description/38",[34,2.689,156,1.716,172,0.883,404,4.53]],["title/39",[725,4.715]],["description/39",[156,1.74,181,2.756]],["title/40",[726,5.377]],["description/40",[104,4.137,156,1.514,727,5.378]],["title/41",[728,5.377]],["description/41",[156,1.496,303,3.264,310,2.548,727,5.312]],["title/42",[729,5.377]],["description/42",[10,1.372,156,1.496,478,3.398,727,5.312]],["title/43",[730,5.377]],["description/43",[84,3.343,150,3.609,193,3.23,244,4.135,569,3.562,725,5.103,731,5.82,732,5.82,733,5.82,734,5.82,735,5.82,736,5.82]],["title/44",[737,5.377]],["description/44",[34,2.689,156,1.478,198,1.478,230,3.502,738,5.783]],["title/45",[739,5.377]],["description/45",[77,4.316,156,1.496,198,1.496,738,5.854]],["title/46",[740,5.377]],["description/46",[156,1.478,172,0.883,198,1.478,478,3.357,741,6.595]],["title/47",[742,5.377]],["description/47",[34,2.722,156,1.496,198,1.496,236,5.312]],["title/48",[743,5.377]],["description/48",[156,1.496,181,2.722,198,1.496,236,5.312]],["title/49",[744,5.377]],["description/49",[104,4.086,156,1.496,198,1.496,745,5.312]],["title/50",[746,5.377]],["description/50",[303,3.264,310,2.548,327,5.312,745,5.312]],["title/51",[747,5.377]],["description/51",[10,1.355,156,1.478,198,1.478,478,3.357,745,5.248]],["title/52",[748,5.377]],["description/52",[34,2.626,156,1.692,198,1.443,230,3.419,749,5.646,750,6.439]],["title/53",[751,5.377]],["description/53",[156,1.46,172,0.873,198,1.704,407,4.213,752,5.714]],["title/54",[753,5.377]],["description/54",[156,1.46,172,0.873,198,1.704,230,3.46,752,5.714]],["title/55",[754,5.377]],["description/55",[156,1.46,172,0.873,198,1.704,478,3.317,755,6.516]],["title/56",[756,5.377]],["description/56",[34,2.689,172,0.883,198,1.478,310,2.517,757,5.783]],["title/57",[758,5.377]],["description/57",[172,0.883,181,2.689,193,3.661,198,1.478,757,5.783]],["title/58",[759,5.377]],["description/58",[104,4.086,198,1.496,310,2.548,760,5.312]],["title/59",[761,5.377]],["description/59",[172,0.883,198,1.478,303,3.224,310,2.517,760,5.248]],["title/60",[762,5.377]],["description/60",[172,0.852,198,1.426,251,2.429,310,2.429,384,3.703,722,5.967,760,5.064]],["title/61",[763,5.377]],["description/61",[34,2.626,172,0.863,198,1.443,230,3.419,327,5.124,749,5.646,764,6.439]],["title/62",[765,5.377]],["description/62",[34,2.657,172,0.873,198,1.46,251,2.487,766,6.516,767,5.185]],["title/63",[768,5.377]],["description/63",[77,4.213,172,0.873,193,3.617,198,1.46,251,2.487,767,5.185]],["title/64",[769,5.377]],["description/64",[36,1.42,156,1.004,196,2.741,198,1.519,207,3.335,220,3.335,251,3.084,273,3.928,322,4.418,366,3.885,520,3.928,599,3.928,715,3.564,722,3.564,723,5.269,767,3.564,770,6.009,771,4.479,772,4.479,773,3.564,774,6.009,775,6.009,776,3.564,777,4.479,778,4.479,779,4.479,780,4.479]],["title/65",[74,1.382,84,2.05]],["description/65",[]],["title/66",[34,1.288,74,1.002,165,1.381,172,0.423]],["description/66",[16,3.882,18,1.313,19,1.598,29,2.037,36,2.016,64,2.649,74,2.552,81,4.846,83,1.767,136,3.205,142,1.848,165,3.194,172,0.907,194,2.447,195,1.848,196,4.143,197,1.937,255,2.649,297,2.649,415,2.447,449,2.649,521,2.919,630,4.143,781,2.649,782,3.329,783,3.329,784,4.878,785,5.06,786,3.329,787,3.329,788,3.329,789,3.329,790,3.329,791,3.329,792,3.329,793,3.329]],["title/67",[84,2.05,665,2.993]],["description/67",[]],["title/68",[19,0.794,665,2.17,670,2.043,794,2.77]],["description/68",[17,1.157,18,0.896,19,1.833,36,0.721,74,0.721,81,4.79,123,1.435,150,2.857,172,0.304,200,2.215,210,1.262,271,1.391,298,3.346,299,2.896,307,3.191,319,2.896,330,3.991,338,1.069,345,1.322,366,2.353,451,1.809,482,1.671,509,3.191,516,1.469,563,3.826,665,3.126,670,5.345,683,1.561,794,5.812,795,7.408,796,2.896,797,2.273,798,3.639,799,3.639,800,3.639,801,4.551,802,2.273,803,3.91,804,1.671,805,2.273,806,2.273,807,5.204,808,3.639,809,2.273,810,2.273,811,2.273,812,2.273,813,3.639,814,1.671,815,2.273,816,2.273]],["title/69",[84,2.05,172,0.584]],["description/69",[]],["title/70",[34,1.359,195,1.131,227,1.248,272,0.747,776,1.622,817,1.622]],["description/70",[1,2.859,19,1.553,34,2.52,174,3.434,195,2.593,227,2.859,244,3.596,272,1.8,305,1.141,310,1.783,527,3.717,570,2.197,591,3.717,776,4.917,818,4.671,819,6.18,820,6.925,821,6.18,822,4.671,823,6.18,824,4.671,825,4.671,826,4.671,827,4.096]],["title/71",[181,1.777,272,0.976]],["description/71",[77,3.931,136,3.375,165,2.657,181,2.479,211,3.538,227,3.721,272,1.362,614,5.331,630,4.467,827,5.331,828,6.08]],["title/72",[272,0.708,405,1.486,630,1.934,829,2.17]],["description/72",[142,3.574,244,3.747,272,1.443,405,3.029,570,3.029,630,3.941,830,5.124]],["title/73",[91,2.131,272,0.821,310,1.398]],["description/73",[91,3.747,112,3.419,272,1.443,310,2.458,569,3.941,830,5.124,831,4.734]],["title/74",[172,0.372,272,0.954,608,1.796,832,2.777]],["description/74",[830,5.515]],["title/75",[165,1.381,272,0.708,478,1.608,630,1.934]],["description/75",[6,2.863,34,2.103,82,2.739,136,2.863,165,2.254,194,3.792,220,2.863,272,1.477,303,2.522,318,3.543,356,2.863,371,3.001,407,3.335,449,4.105,478,3.697,533,4.523,630,4.685,803,4.527,831,3.792,833,5.158,834,5.158]],["title/76",[34,1.01,272,0.555,305,0.605,570,1.165,817,1.972,835,1.602]],["description/76",[179,3.617,244,3.792,272,1.46,305,1.591,835,4.213,836,5.714]],["title/77",[181,1.288,272,0.708,305,0.771,570,1.486]],["description/77",[1,2.44,17,2.029,19,1.002,40,2.578,81,3.588,159,4.416,165,1.743,180,1.626,181,3.143,242,3.496,244,3.229,305,1.919,405,2.61,411,3.173,412,2.32,532,3.496,707,3.173,773,3.173,781,3.173,796,3.173,804,2.931,814,2.931,836,3.496,837,6.052,838,3.987,839,4.866,840,3.987,841,3.987,842,4.74,843,3.987,844,5.08,845,3.496,846,3.496]],["title/78",[19,0.47,197,1.089,272,0.42,305,0.457,342,0.881,405,0.881,430,1.146,570,1.461]],["description/78",[19,1.599,197,3.703,305,1.554,342,2.993,405,2.993,430,3.895,570,2.993,847,6.364]],["title/79",[172,0.491,305,0.894,829,2.516]],["description/79",[6,2.945,18,2.093,19,1.849,74,2.452,112,3.274,150,1.759,172,0.826,200,1.299,210,2.076,226,2.418,305,1.848,342,1.759,345,2.177,371,2.177,405,2.901,409,3.28,440,2.977,569,3.248,647,2.977,670,4.581,683,2.569,785,2.977,803,3.644,804,2.75,829,2.569,844,2.977,848,3.28,849,3.741,850,3.28,851,4.653,852,3.28,853,3.28,854,3.28,855,3.28,856,2.75]],["title/80",[303,1.791,305,0.894,842,2.516]],["description/80",[1,2.184,17,2.612,18,2.024,19,1.289,29,2.184,59,4.499,77,2.307,91,2.077,129,3.129,159,2.84,165,2.243,181,2.092,193,2.848,298,3.772,303,2.937,305,1.769,318,2.451,356,3.335,404,2.451,405,1.679,408,2.184,415,2.624,527,2.84,544,2.451,667,2.84,773,2.84,781,2.84,837,4.499,839,3.129,842,4.78,844,4.781,845,3.129,846,3.129,856,2.624,857,3.569,858,5.131,859,3.569,860,3.569,861,3.569,862,6.569,863,5.131,864,3.569,865,3.569,866,3.569,867,3.569,868,3.569]],["title/81",[172,0.491,305,0.894,608,2.368]],["description/81",[172,0.894,305,1.63,478,3.398,856,4.908]],["title/82",[91,2.131,305,0.894,310,1.398]],["description/82",[91,3.618,112,3.302,270,3.452,272,1.393,305,1.518,310,2.374,569,3.806,570,2.925,831,4.572,856,4.572]],["title/83",[193,1.375,305,0.605,404,1.702,408,2.385,869,1.822]],["description/83",[82,3.123,136,3.265,272,1.318,305,1.747,338,2.767,356,3.265,371,3.423,418,4.681,544,4.04,835,3.803,869,4.325,870,5.158,871,5.158,872,5.883]],["title/84",[101,1.822,700,1.972,796,1.972,814,1.822,873,2.478,874,2.478]],["description/84",[875,6.931]],["title/85",[305,0.894,814,2.693,876,3.663]],["description/85",[877,6.931]],["title/86",[72,1.517,303,1.211,305,0.605,411,1.972,412,1.442,842,1.702]],["description/86",[878,6.931]],["title/87",[34,1.01,272,0.555,559,0.946,570,1.165,817,1.972,835,1.602]],["description/87",[179,3.617,244,3.792,272,1.46,559,2.487,835,4.213,879,5.714]],["title/88",[181,1.288,272,0.708,559,1.206,570,1.486]],["description/88",[181,2.689,272,1.478,559,2.517,570,3.102,879,5.783]],["title/89",[172,0.491,559,1.398,829,2.516]],["description/89",[6,3.049,18,1.55,19,1.813,74,2.434,112,3.363,150,1.848,172,0.848,200,1.364,210,2.181,226,2.541,342,1.848,345,2.286,405,2.979,440,3.127,559,2.854,569,3.362,647,3.127,670,4.666,683,2.699,785,3.127,803,3.773,804,2.889,829,2.699,848,3.446,850,3.446,851,4.817,852,3.446,853,3.446,854,3.446,855,3.446,880,3.93,881,2.889]],["title/90",[297,3.468,559,1.663]],["description/90",[303,3.264,559,2.548,842,4.585,881,4.908]],["title/91",[172,0.491,559,1.398,608,2.368]],["description/91",[172,0.894,478,3.398,559,2.548,881,4.908]],["title/92",[91,2.131,310,1.398,559,1.398]],["description/92",[91,3.577,244,3.577,270,3.413,272,1.378,310,2.347,559,2.347,569,3.763,570,2.892,803,4.223,831,4.52,881,4.52]],["title/93",[193,1.375,404,1.702,408,2.385,559,0.946,869,1.822]],["description/93",[82,3.123,136,3.265,272,1.318,338,2.767,356,3.265,371,3.423,418,4.681,544,4.04,559,2.731,835,3.803,869,4.325,870,5.158,871,5.158,882,5.883]]],"invertedIndex":[["",{"_index":36,"title":{"5":{}},"description":{"1":{},"2":{},"3":{},"4":{},"5":{},"6":{},"7":{},"9":{},"11":{},"12":{},"19":{},"20":{},"21":{},"22":{},"23":{},"25":{},"26":{},"27":{},"29":{},"30":{},"31":{},"64":{},"66":{},"68":{}}}],["1",{"_index":319,"title":{},"description":{"5":{},"8":{},"68":{}}}],["2",{"_index":509,"title":{},"description":{"8":{},"68":{}}}],["2.0",{"_index":349,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["21",{"_index":69,"title":{},"description":{"1":{}}}],["3",{"_index":798,"title":{},"description":{"68":{}}}],["3.5](https://spark.apache.org/releases/spark-release-3-5-0.html",{"_index":94,"title":{},"description":{"1":{},"5":{}}}],["6",{"_index":328,"title":{},"description":{"5":{}}}],["7",{"_index":329,"title":{},"description":{"5":{}}}],["8693",{"_index":854,"title":{},"description":{"79":{},"89":{}}}],["_databases_",{"_index":553,"title":{},"description":{"13":{}}}],["_note",{"_index":283,"title":{},"description":{"5":{}}}],["_schemas_",{"_index":552,"title":{},"description":{"13":{}}}],["_storag",{"_index":542,"title":{},"description":{"12":{}}}],["a.b.c.d.e.f.g",{"_index":554,"title":{},"description":{"13":{}}}],["abil",{"_index":260,"title":{},"description":{"4":{},"5":{},"25":{}}}],["abov",{"_index":105,"title":{},"description":{"2":{},"5":{},"27":{},"29":{}}}],["above](#building-and-deploying-polari",{"_index":90,"title":{},"description":{"1":{}}}],["above](#defining-a-catalog",{"_index":234,"title":{},"description":{"4":{}}}],["access",{"_index":200,"title":{"9":{},"20":{},"25":{}},"description":{"4":{},"5":{},"6":{},"7":{},"9":{},"12":{},"16":{},"17":{},"18":{},"19":{},"20":{},"21":{},"23":{},"24":{},"25":{},"26":{},"68":{},"79":{},"89":{}}}],["account",{"_index":820,"title":{},"description":{"70":{}}}],["accounting.tax",{"_index":824,"title":{},"description":{"70":{}}}],["accounting.tax.paid.info",{"_index":818,"title":{},"description":{"70":{}}}],["action",{"_index":508,"title":{},"description":{"8":{},"23":{}}}],["activ",{"_index":326,"title":{},"description":{"5":{}}}],["actor",{"_index":809,"title":{},"description":{"68":{}}}],["add",{"_index":77,"title":{},"description":{"1":{},"34":{},"45":{},"63":{},"71":{},"80":{}}}],["addgranttocatalogrol",{"_index":768,"title":{"63":{}},"description":{}}],["addit",{"_index":345,"title":{},"description":{"6":{},"7":{},"11":{},"20":{},"27":{},"68":{},"79":{},"89":{}}}],["addition",{"_index":217,"title":{},"description":{"4":{},"12":{},"27":{},"31":{}}}],["addschemaupd",{"_index":845,"title":{},"description":{"77":{},"80":{}}}],["adjust",{"_index":479,"title":{},"description":{"7":{},"27":{},"31":{}}}],["admin",{"_index":134,"title":{},"description":{"2":{},"26":{}}}],["administr",{"_index":467,"title":{},"description":{"7":{},"20":{},"22":{},"23":{},"24":{},"26":{}}}],["affect",{"_index":780,"title":{},"description":{"64":{}}}],["afterward",{"_index":712,"title":{},"description":{"27":{},"30":{}}}],["agre",{"_index":358,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["agreement",{"_index":340,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["ai",{"_index":464,"title":{},"description":{"7":{},"22":{},"26":{}}}],["alic",{"_index":506,"title":{},"description":{"8":{},"26":{}}}],["allow",{"_index":516,"title":{},"description":{"9":{},"23":{},"27":{},"30":{},"31":{},"68":{}}}],["alter",{"_index":607,"title":{},"description":{"23":{}}}],["amazon",{"_index":490,"title":{},"description":{"7":{}}}],["analog",{"_index":525,"title":{},"description":{"9":{}}}],["and/or",{"_index":533,"title":{},"description":{"10":{},"75":{}}}],["anoth",{"_index":418,"title":{},"description":{"7":{},"83":{},"93":{}}}],["apach",{"_index":9,"title":{"28":{}},"description":{"0":{},"1":{},"5":{},"6":{},"7":{},"8":{},"10":{},"11":{},"12":{},"14":{},"15":{},"20":{},"24":{},"26":{},"27":{}}}],["apache&reg",{"_index":529,"title":{},"description":{"10":{}}}],["api",{"_index":84,"title":{"65":{},"67":{},"69":{}},"description":{"1":{},"5":{},"12":{},"13":{},"14":{},"15":{},"16":{},"17":{},"19":{},"43":{}}}],["appear",{"_index":432,"title":{},"description":{"7":{}}}],["appli",{"_index":784,"title":{},"description":{"66":{}}}],["applic",{"_index":133,"title":{},"description":{"2":{},"6":{},"11":{},"20":{},"27":{}}}],["appropri",{"_index":279,"title":{},"description":{"5":{}}}],["architectur",{"_index":400,"title":{},"description":{"7":{}}}],["arctic",{"_index":422,"title":{},"description":{"7":{}}}],["arn",{"_index":215,"title":{},"description":{"4":{}}}],["arn</li><li>extern",{"_index":495,"title":{},"description":{"7":{}}}],["arn](https://docs.aws.amazon.com/iam/latest/userguide/reference-arns.html",{"_index":199,"title":{},"description":{"4":{}}}],["asf",{"_index":337,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["asid",{"_index":733,"title":{},"description":{"43":{}}}],["assert",{"_index":858,"title":{},"description":{"80":{}}}],["assert-cr",{"_index":867,"title":{},"description":{"80":{}}}],["assert-ref-snapshot-id",{"_index":860,"title":{},"description":{"80":{}}}],["assign",{"_index":230,"title":{},"description":{"4":{},"16":{},"17":{},"18":{},"20":{},"24":{},"44":{},"52":{},"54":{},"61":{}}}],["assigncatalogroletoprincipalrol",{"_index":753,"title":{"54":{}},"description":{}}],["assignprincipalrol",{"_index":739,"title":{"45":{}},"description":{}}],["associ",{"_index":384,"title":{},"description":{"7":{},"12":{},"13":{},"14":{},"15":{},"16":{},"17":{},"60":{}}}],["assum",{"_index":276,"title":{},"description":{"5":{}}}],["asymmetric](https://github.com/apache/polaris/blob/b482617bf8cc508b37dbedf3ebc81a9408160a5e/polaris-service/src/main/java/io/polaris/service/auth/jwtrsakeypair.java#l24",{"_index":677,"title":{},"description":{"27":{},"29":{}}}],["atom",{"_index":411,"title":{"86":{}},"description":{"7":{},"77":{}}}],["attempt",{"_index":859,"title":{},"description":{"80":{}}}],["authent",{"_index":205,"title":{},"description":{"4":{},"27":{},"29":{}}}],["authenticator.tokenbrok",{"_index":679,"title":{},"description":{"27":{},"29":{}}}],["author",{"_index":330,"title":{},"description":{"5":{},"68":{}}}],["automat",{"_index":148,"title":{},"description":{"3":{}}}],["avail",{"_index":545,"title":{},"description":{"12":{},"25":{}}}],["azur",{"_index":212,"title":{},"description":{"4":{},"7":{},"12":{}}}],["b",{"_index":555,"title":{},"description":{"13":{}}}],["backend",{"_index":700,"title":{"84":{}},"description":{"27":{},"30":{}}}],["base",{"_index":492,"title":{},"description":{"7":{},"17":{},"18":{}}}],["bash",{"_index":709,"title":{},"description":{"27":{},"30":{}}}],["basi",{"_index":359,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["be",{"_index":262,"title":{},"description":{"4":{}}}],["bearer",{"_index":683,"title":{},"description":{"27":{},"29":{},"68":{},"79":{},"89":{}}}],["befor",{"_index":29,"title":{},"description":{"1":{},"2":{},"4":{},"27":{},"30":{},"66":{},"80":{}}}],["begin",{"_index":843,"title":{},"description":{"77":{}}}],["behavior",{"_index":779,"title":{},"description":{"64":{}}}],["belong",{"_index":429,"title":{},"description":{"7":{},"23":{}}}],["below",{"_index":87,"title":{},"description":{"1":{},"3":{},"27":{},"29":{}}}],["beneath",{"_index":676,"title":{},"description":{"27":{},"29":{}}}],["best",{"_index":659,"title":{},"description":{"27":{},"28":{}}}],["bestow",{"_index":480,"title":{},"description":{"7":{},"23":{}}}],["between",{"_index":488,"title":{},"description":{"7":{},"22":{},"23":{},"24":{}}}],["bi",{"_index":461,"title":{},"description":{"7":{}}}],["bigint",{"_index":315,"title":{},"description":{"5":{}}}],["bin/spark-shel",{"_index":285,"title":{},"description":{"5":{}}}],["bob",{"_index":504,"title":{},"description":{"8":{},"26":{}}}],["bodi",{"_index":831,"title":{},"description":{"73":{},"75":{},"82":{},"92":{}}}],["bootstrap",{"_index":138,"title":{"3":{}},"description":{"3":{},"27":{},"30":{}}}],["both",{"_index":647,"title":{},"description":{"26":{},"79":{},"89":{}}}],["br",{"_index":605,"title":{},"description":{"23":{}}}],["branch",{"_index":93,"title":{},"description":{"1":{},"5":{}}}],["branch-3.5",{"_index":97,"title":{},"description":{"1":{},"5":{}}}],["brew",{"_index":48,"title":{},"description":{"1":{}}}],["broker",{"_index":671,"title":{},"description":{"27":{},"29":{}}}],["bronz",{"_index":651,"title":{},"description":{"26":{}}}],["bucket</li></ul",{"_index":497,"title":{},"description":{"7":{}}}],["bucket</li><li>loc",{"_index":493,"title":{},"description":{"7":{}}}],["bucket</li><li>s3",{"_index":494,"title":{},"description":{"7":{}}}],["build",{"_index":13,"title":{},"description":{"0":{},"1":{},"2":{}}}],["built",{"_index":65,"title":{},"description":{"1":{},"6":{}}}],["call",{"_index":194,"title":{},"description":{"4":{},"9":{},"66":{},"75":{}}}],["callcontextresolv",{"_index":680,"title":{},"description":{"27":{},"29":{}}}],["callcontextresolver](https://github.com/apache/polaris/blob/8290019c10290a600e40b35ddb1e2f54bf99e120/polaris-service/src/main/java/io/polaris/service/context/callcontextresolver.java#l27",{"_index":686,"title":{},"description":{"27":{},"29":{}}}],["cascad",{"_index":723,"title":{},"description":{"37":{},"64":{}}}],["case",{"_index":273,"title":{},"description":{"4":{},"64":{}}}],["cask",{"_index":57,"title":{},"description":{"1":{}}}],["catalog",{"_index":172,"title":{"4":{},"12":{},"18":{},"23":{},"66":{},"69":{},"74":{},"79":{},"81":{},"89":{},"91":{}},"description":{"4":{},"5":{},"6":{},"7":{},"8":{},"9":{},"12":{},"16":{},"18":{},"19":{},"20":{},"21":{},"22":{},"23":{},"24":{},"25":{},"26":{},"27":{},"30":{},"31":{},"33":{},"34":{},"35":{},"36":{},"37":{},"38":{},"46":{},"53":{},"54":{},"55":{},"56":{},"57":{},"59":{},"60":{},"61":{},"62":{},"63":{},"66":{},"68":{},"79":{},"81":{},"89":{},"91":{}}}],["catalog'",{"_index":808,"title":{},"description":{"68":{}}}],["catalog-rol",{"_index":238,"title":{},"description":{"4":{},"5":{}}}],["catalog.<br",{"_index":604,"title":{},"description":{"23":{}}}],["catalog1",{"_index":390,"title":{},"description":{"7":{},"8":{}}}],["catalog2",{"_index":391,"title":{},"description":{"7":{}}}],["catalog3",{"_index":392,"title":{},"description":{"7":{}}}],["catalog](#catalog",{"_index":550,"title":{},"description":{"13":{}}}],["catalog](#defining-a-catalog",{"_index":115,"title":{},"description":{"2":{}}}],["catalog](./entities.md#catalog",{"_index":173,"title":{},"description":{"4":{}}}],["catalog](./img/quickstart/privilege-illustration-1.png",{"_index":257,"title":{},"description":{"4":{}}}],["catalog_manage_access",{"_index":639,"title":{},"description":{"25":{}}}],["catalog_manage_cont",{"_index":265,"title":{},"description":{"4":{},"5":{},"25":{}}}],["catalog_manage_metadata",{"_index":642,"title":{},"description":{"25":{}}}],["catalog_read_properti",{"_index":643,"title":{},"description":{"25":{}}}],["catalog_write_properti",{"_index":644,"title":{},"description":{"25":{}}}],["catalogs/{catalognam",{"_index":719,"title":{},"description":{"35":{},"36":{},"37":{}}}],["catalogs/{catalogname}/catalog-rol",{"_index":757,"title":{},"description":{"56":{},"57":{}}}],["catalogs/{catalogname}/catalog-roles/{catalogrolenam",{"_index":760,"title":{},"description":{"58":{},"59":{},"60":{}}}],["catalogs/{catalogname}/catalog-roles/{catalogrolename}/gr",{"_index":767,"title":{},"description":{"62":{},"63":{},"64":{}}}],["catalogs/{catalogname}/catalog-roles/{catalogrolename}/principal-rol",{"_index":764,"title":{},"description":{"61":{}}}],["catalogs](#catalog",{"_index":572,"title":{},"description":{"18":{}}}],["catalogs](https://iceberg.apache.org/concepts/catalog",{"_index":540,"title":{},"description":{"12":{}}}],["cd",{"_index":50,"title":{},"description":{"1":{},"2":{},"4":{}}}],["central",{"_index":375,"title":{},"description":{"6":{},"9":{}}}],["certain",{"_index":527,"title":{},"description":{"9":{},"70":{},"80":{}}}],["chang",{"_index":844,"title":{},"description":{"77":{},"79":{},"80":{}}}],["check",{"_index":91,"title":{"73":{},"82":{},"92":{}},"description":{"1":{},"73":{},"80":{},"82":{},"92":{}}}],["checkout",{"_index":96,"title":{},"description":{"1":{}}}],["child",{"_index":865,"title":{},"description":{"80":{}}}],["claim",{"_index":799,"title":{},"description":{"68":{}}}],["class",{"_index":581,"title":{},"description":{"19":{}}}],["cli",{"_index":168,"title":{},"description":{"3":{},"4":{},"5":{}}}],["client",{"_index":81,"title":{},"description":{"1":{},"5":{},"7":{},"66":{},"68":{},"77":{}}}],["client-id",{"_index":182,"title":{},"description":{"4":{},"5":{}}}],["client-id>:<client-secret",{"_index":163,"title":{},"description":{"3":{}}}],["client-secret",{"_index":184,"title":{},"description":{"4":{},"5":{}}}],["client-specif",{"_index":789,"title":{},"description":{"66":{}}}],["client_id",{"_index":183,"title":{},"description":{"4":{},"5":{}}}],["client_id=<client-id",{"_index":170,"title":{},"description":{"3":{}}}],["client_secret",{"_index":185,"title":{},"description":{"4":{},"5":{}}}],["client_secret=<client-secret",{"_index":171,"title":{},"description":{"3":{}}}],["clientid",{"_index":246,"title":{},"description":{"4":{}}}],["clientsecret",{"_index":248,"title":{},"description":{"4":{}}}],["clone",{"_index":41,"title":{},"description":{"1":{},"5":{}}}],["cloud",{"_index":397,"title":{},"description":{"7":{},"9":{}}}],["code",{"_index":38,"title":{},"description":{"1":{}}}],["command",{"_index":241,"title":{},"description":{"4":{},"5":{}}}],["command-lin",{"_index":26,"title":{},"description":{"1":{}}}],["commit",{"_index":842,"title":{"80":{},"86":{}},"description":{"77":{},"80":{},"90":{}}}],["common",{"_index":791,"title":{},"description":{"66":{}}}],["compat",{"_index":67,"title":{},"description":{"1":{}}}],["complet",{"_index":242,"title":{},"description":{"4":{},"77":{}}}],["complianc",{"_index":351,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["compos",{"_index":107,"title":{},"description":{"2":{}}}],["concept",{"_index":382,"title":{"7":{}},"description":{"7":{},"20":{}}}],["conceptu",{"_index":379,"title":{},"description":{"6":{}}}],["concurr",{"_index":868,"title":{},"description":{"80":{}}}],["condit",{"_index":362,"title":{},"description":{"6":{},"7":{},"11":{},"20":{},"27":{}}}],["conf",{"_index":287,"title":{},"description":{"5":{}}}],["configur",{"_index":74,"title":{"27":{},"28":{},"31":{},"65":{},"66":{}},"description":{"1":{},"3":{},"4":{},"5":{},"7":{},"9":{},"12":{},"22":{},"23":{},"25":{},"26":{},"27":{},"28":{},"29":{},"30":{},"31":{},"66":{},"68":{},"79":{},"89":{}}}],["connect",{"_index":79,"title":{},"description":{"1":{},"5":{},"7":{},"8":{},"9":{},"22":{},"26":{},"27":{},"30":{}}}],["consid",{"_index":692,"title":{},"description":{"27":{},"30":{},"31":{}}}],["consist",{"_index":521,"title":{},"description":{"9":{},"66":{}}}],["construct",{"_index":786,"title":{},"description":{"66":{}}}],["contain",{"_index":112,"title":{},"description":{"2":{},"7":{},"12":{},"13":{},"27":{},"30":{},"73":{},"79":{},"82":{},"89":{}}}],["container</li><li>azur",{"_index":500,"title":{},"description":{"7":{}}}],["container</li><li>loc",{"_index":499,"title":{},"description":{"7":{}}}],["content",{"_index":264,"title":{},"description":{"4":{},"25":{}}}],["context",{"_index":806,"title":{},"description":{"68":{}}}],["continu",{"_index":113,"title":{},"description":{"2":{}}}],["contributor",{"_index":339,"title":{},"description":{"6":{},"11":{},"20":{},"23":{},"26":{},"27":{}}}],["control",{"_index":470,"title":{"9":{},"20":{},"25":{}},"description":{"7":{},"9":{},"20":{},"25":{},"26":{}}}],["control](access-control.md",{"_index":473,"title":{},"description":{"7":{},"9":{}}}],["copi",{"_index":353,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["copyright",{"_index":347,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["correct",{"_index":221,"title":{},"description":{"4":{}}}],["correctli",{"_index":435,"title":{},"description":{"7":{}}}],["countri",{"_index":534,"title":{},"description":{"10":{}}}],["cover",{"_index":22,"title":{},"description":{"1":{}}}],["creat",{"_index":181,"title":{"71":{},"77":{},"88":{}},"description":{"4":{},"5":{},"7":{},"8":{},"23":{},"25":{},"26":{},"39":{},"48":{},"57":{},"71":{},"77":{},"80":{},"88":{}}}],["create/list/read/writ",{"_index":269,"title":{},"description":{"4":{}}}],["createcatalog",{"_index":717,"title":{"34":{}},"description":{}}],["createcatalogrol",{"_index":758,"title":{"57":{}},"description":{}}],["createprincip",{"_index":725,"title":{"39":{}},"description":{"43":{}}}],["createprincipalrol",{"_index":743,"title":{"48":{}},"description":{}}],["createt",{"_index":866,"title":{},"description":{"80":{}}}],["creation",{"_index":485,"title":{},"description":{"7":{}}}],["credenti",{"_index":150,"title":{},"description":{"3":{},"4":{},"5":{},"7":{},"9":{},"12":{},"25":{},"27":{},"30":{},"43":{},"68":{},"79":{},"89":{}}}],["credentials._",{"_index":284,"title":{},"description":{"5":{}}}],["cta",{"_index":838,"title":{},"description":{"77":{}}}],["current",{"_index":404,"title":{"83":{},"93":{}},"description":{"7":{},"38":{},"80":{}}}],["custom",{"_index":444,"title":{},"description":{"7":{}}}],["dashboard",{"_index":462,"title":{},"description":{"7":{}}}],["data",{"_index":203,"title":{},"description":{"4":{},"5":{},"7":{},"8":{},"9":{},"12":{},"13":{},"14":{},"15":{},"16":{},"17":{},"18":{},"22":{},"25":{},"26":{}}}],["data_engin",{"_index":593,"title":{},"description":{"22":{},"26":{}}}],["data_scientist",{"_index":594,"title":{},"description":{"22":{},"26":{}}}],["databas",{"_index":695,"title":{},"description":{"27":{},"30":{}}}],["default",{"_index":196,"title":{},"description":{"4":{},"27":{},"28":{},"30":{},"31":{},"64":{},"66":{}}}],["default-base-loc",{"_index":188,"title":{},"description":{"4":{}}}],["default-realm",{"_index":162,"title":{},"description":{"3":{}}}],["default_base_loc",{"_index":189,"title":{},"description":{"4":{}}}],["defaultpolarisauthent",{"_index":675,"title":{},"description":{"27":{},"29":{}}}],["defin",{"_index":114,"title":{"4":{}},"description":{"2":{},"3":{},"7":{}}}],["degre",{"_index":577,"title":{},"description":{"19":{}}}],["deleg",{"_index":524,"title":{},"description":{"9":{}}}],["delet",{"_index":722,"title":{},"description":{"37":{},"60":{},"64":{}}}],["deletecatalog",{"_index":721,"title":{"37":{}},"description":{}}],["deletecatalogrol",{"_index":762,"title":{"60":{}},"description":{}}],["deleteprincip",{"_index":729,"title":{"42":{}},"description":{}}],["deleteprincipalrol",{"_index":747,"title":{"51":{}},"description":{}}],["depend",{"_index":85,"title":{},"description":{"1":{},"5":{},"12":{}}}],["deploy",{"_index":14,"title":{"2":{}},"description":{"0":{},"1":{},"2":{},"27":{},"28":{},"29":{},"31":{}}}],["describ",{"_index":12,"title":{},"description":{"0":{},"9":{},"25":{}}}],["descript",{"_index":592,"title":{},"description":{"22":{},"23":{},"25":{}}}],["destroy",{"_index":145,"title":{},"description":{"3":{}}}],["detail",{"_index":104,"title":{},"description":{"2":{},"4":{},"12":{},"35":{},"40":{},"49":{},"58":{}}}],["develo",{"_index":658,"title":{},"description":{"27":{},"28":{}}}],["diagram",{"_index":380,"title":{},"description":{"6":{},"7":{},"8":{},"24":{},"26":{}}}],["differ",{"_index":214,"title":{},"description":{"4":{},"5":{},"6":{},"9":{},"12":{},"17":{}}}],["directli",{"_index":539,"title":{},"description":{"12":{},"22":{}}}],["directori",{"_index":437,"title":{},"description":{"7":{}}}],["disabl",{"_index":715,"title":{},"description":{"27":{},"31":{},"64":{}}}],["display",{"_index":450,"title":{},"description":{"7":{},"23":{}}}],["distribut",{"_index":343,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["doc",{"_index":582,"title":{},"description":{"19":{}}}],["docker",{"_index":52,"title":{},"description":{"1":{},"2":{}}}],["docker-compose.yml",{"_index":109,"title":{},"description":{"2":{}}}],["docker](https://www.docker.com",{"_index":24,"title":{},"description":{"1":{}}}],["docs](../regtests/client/python/docs/createcatalogrequest.md",{"_index":541,"title":{},"description":{"12":{}}}],["docs](../regtests/client/python/docs/createnamespacerequest.md",{"_index":556,"title":{},"description":{"13":{}}}],["docs](../regtests/client/python/docs/createprincipalrequest.md",{"_index":565,"title":{},"description":{"16":{}}}],["docs](../regtests/client/python/docs/createprincipalrolerequest.md",{"_index":571,"title":{},"description":{"17":{}}}],["docs](../regtests/client/python/docs/createtablerequest.md",{"_index":558,"title":{},"description":{"14":{}}}],["docs](../regtests/client/python/docs/createviewrequest.md",{"_index":561,"title":{},"description":{"15":{}}}],["docs](../regtests/client/python/docs/storageconfiginfo.md",{"_index":549,"title":{},"description":{"12":{}}}],["docs](./command-line-interface.md",{"_index":229,"title":{},"description":{"4":{}}}],["docs](./configuring-polaris-for-production.md",{"_index":154,"title":{},"description":{"3":{}}}],["docs](./entities.md#storage-typ",{"_index":216,"title":{},"description":{"4":{}}}],["document",{"_index":255,"title":{},"description":{"4":{},"11":{},"66":{}}}],["documentation](https://iceberg.apache.org/concepts/catalog",{"_index":414,"title":{},"description":{"7":{}}}],["doesn't",{"_index":475,"title":{},"description":{"7":{}}}],["don't",{"_index":589,"title":{},"description":{"22":{}}}],["done",{"_index":56,"title":{},"description":{"1":{}}}],["down",{"_index":147,"title":{},"description":{"3":{},"4":{}}}],["dremio",{"_index":421,"title":{},"description":{"7":{}}}],["drop",{"_index":608,"title":{"74":{},"81":{},"91":{}},"description":{"23":{},"25":{},"37":{}}}],["durabl",{"_index":697,"title":{},"description":{"27":{},"30":{}}}],["dure",{"_index":484,"title":{},"description":{"7":{},"9":{}}}],["each",{"_index":447,"title":{},"description":{"7":{},"12":{},"16":{},"17":{},"18":{},"19":{},"24":{}}}],["eclipse-link",{"_index":693,"title":{},"description":{"27":{},"30":{}}}],["eclipselink",{"_index":701,"title":{},"description":{"27":{},"30":{}}}],["eclipselink](https://eclipse.dev/eclipselink",{"_index":702,"title":{},"description":{"27":{},"30":{}}}],["effect",{"_index":599,"title":{},"description":{"23":{},"64":{}}}],["elsewher",{"_index":302,"title":{},"description":{"5":{}}}],["empti",{"_index":832,"title":{"74":{}},"description":{}}],["emul",{"_index":603,"title":{},"description":{"23":{}}}],["enabl",{"_index":398,"title":{},"description":{"7":{},"25":{}}}],["encapsul",{"_index":448,"title":{},"description":{"7":{}}}],["encompass",{"_index":640,"title":{},"description":{"25":{}}}],["endpoint",{"_index":796,"title":{"84":{}},"description":{"68":{},"77":{}}}],["enforc",{"_index":434,"title":{},"description":{"7":{},"9":{}}}],["engin",{"_index":204,"title":{},"description":{"4":{},"5":{},"6":{},"7":{},"9":{},"22":{},"26":{}}}],["ensur",{"_index":667,"title":{},"description":{"27":{},"29":{},"80":{}}}],["entiti",{"_index":7,"title":{"11":{}},"description":{"0":{},"3":{},"4":{},"7":{},"9":{},"11":{},"12":{},"13":{},"14":{},"15":{},"16":{},"17":{},"18":{},"19":{},"27":{},"30":{}}}],["environ",{"_index":166,"title":{},"description":{"3":{}}}],["etc",{"_index":614,"title":{},"description":{"25":{},"71":{}}}],["etl",{"_index":456,"title":{},"description":{"7":{}}}],["eventu",{"_index":121,"title":{},"description":{"2":{}}}],["everyth",{"_index":266,"title":{},"description":{"4":{}}}],["exampl",{"_index":18,"title":{"8":{},"26":{}},"description":{"0":{},"1":{},"3":{},"4":{},"7":{},"8":{},"13":{},"22":{},"23":{},"25":{},"26":{},"66":{},"68":{},"79":{},"80":{},"89":{}}}],["example](access-control.md#rbac-exampl",{"_index":481,"title":{},"description":{"7":{}}}],["except",{"_index":350,"title":{},"description":{"6":{},"11":{},"20":{},"25":{},"27":{}}}],["exchang",{"_index":795,"title":{},"description":{"68":{}}}],["execut",{"_index":515,"title":{},"description":{"9":{}}}],["exist",{"_index":310,"title":{"73":{},"82":{},"92":{}},"description":{"5":{},"7":{},"27":{},"30":{},"36":{},"37":{},"41":{},"50":{},"56":{},"58":{},"59":{},"60":{},"70":{},"73":{},"82":{},"92":{}}}],["expect",{"_index":864,"title":{},"description":{"80":{}}}],["expir",{"_index":801,"title":{},"description":{"68":{}}}],["export",{"_index":169,"title":{},"description":{"3":{}}}],["express",{"_index":364,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["extern",{"_index":275,"title":{},"description":{"5":{},"7":{},"9":{}}}],["f",{"_index":108,"title":{},"description":{"2":{}}}],["fals",{"_index":840,"title":{},"description":{"77":{}}}],["featureconfiguration.supported_catalog_storage_typ",{"_index":714,"title":{},"description":{"27":{},"31":{}}}],["few",{"_index":63,"title":{},"description":{"1":{}}}],["file",{"_index":342,"title":{"78":{}},"description":{"6":{},"7":{},"9":{},"11":{},"12":{},"20":{},"27":{},"30":{},"31":{},"78":{},"79":{},"89":{}}}],["file](https://eclipse.dev/eclipselink/documentation/2.5/solutions/testingjpa002.htm",{"_index":705,"title":{},"description":{"27":{},"30":{}}}],["fileio",{"_index":849,"title":{},"description":{"79":{}}}],["filesystem",{"_index":306,"title":{},"description":{"5":{},"27":{},"31":{}}}],["final",{"_index":16,"title":{},"description":{"0":{},"5":{},"66":{}}}],["find",{"_index":278,"title":{},"description":{"5":{}}}],["fine-grain",{"_index":612,"title":{},"description":{"25":{}}}],["first",{"_index":64,"title":{},"description":{"1":{},"7":{},"66":{}}}],["flag",{"_index":225,"title":{},"description":{"4":{}}}],["flink",{"_index":452,"title":{},"description":{"7":{}}}],["flink&reg",{"_index":454,"title":{},"description":{"7":{},"10":{}}}],["flow",{"_index":794,"title":{"68":{}},"description":{"68":{}}}],["follow",{"_index":127,"title":{},"description":{"2":{},"5":{},"7":{},"8":{},"21":{},"22":{},"23":{},"24":{},"25":{},"26":{},"27":{},"31":{}}}],["forbidden",{"_index":325,"title":{},"description":{"5":{}}}],["form",{"_index":399,"title":{},"description":{"7":{}}}],["found",{"_index":157,"title":{},"description":{"3":{}}}],["foundat",{"_index":336,"title":{},"description":{"6":{},"10":{},"11":{},"20":{},"27":{}}}],["full",{"_index":226,"title":{},"description":{"4":{},"23":{},"25":{},"26":{},"79":{},"89":{}}}],["fulli",{"_index":263,"title":{},"description":{"4":{}}}],["gc",{"_index":426,"title":{},"description":{"7":{},"12":{}}}],["gener",{"_index":300,"title":{},"description":{"5":{},"7":{}}}],["getcatalog",{"_index":718,"title":{"35":{}},"description":{}}],["getcatalogrol",{"_index":759,"title":{"58":{}},"description":{}}],["getprincip",{"_index":726,"title":{"40":{}},"description":{}}],["getprincipalrol",{"_index":744,"title":{"49":{}},"description":{}}],["git",{"_index":45,"title":{},"description":{"1":{}}}],["git](https://git-scm.com",{"_index":43,"title":{},"description":{"1":{}}}],["give",{"_index":259,"title":{},"description":{"4":{}}}],["given",{"_index":570,"title":{"76":{},"77":{},"78":{},"87":{},"88":{}},"description":{"17":{},"19":{},"70":{},"72":{},"78":{},"82":{},"88":{},"92":{}}}],["glue",{"_index":420,"title":{},"description":{"7":{}}}],["gold",{"_index":649,"title":{},"description":{"26":{}}}],["googl",{"_index":396,"title":{},"description":{"7":{}}}],["govern",{"_index":368,"title":{},"description":{"6":{},"9":{},"11":{},"20":{},"27":{}}}],["gradle](https://gradle.org",{"_index":66,"title":{},"description":{"1":{}}}],["gradlew",{"_index":116,"title":{},"description":{"2":{}}}],["grant",{"_index":251,"title":{},"description":{"4":{},"5":{},"7":{},"9":{},"17":{},"18":{},"19":{},"20":{},"21":{},"22":{},"23":{},"24":{},"25":{},"26":{},"37":{},"60":{},"62":{},"63":{},"64":{}}}],["group",{"_index":428,"title":{},"description":{"7":{},"18":{},"22":{}}}],["guid",{"_index":2,"title":{},"description":{"0":{},"1":{},"5":{}}}],["hadoop-aw",{"_index":304,"title":{},"description":{"5":{}}}],["handl",{"_index":805,"title":{},"description":{"68":{}}}],["header",{"_index":813,"title":{},"description":{"68":{}}}],["here",{"_index":35,"title":{},"description":{"1":{},"5":{},"27":{},"29":{}}}],["hierarchi",{"_index":439,"title":{},"description":{"7":{}}}],["hold",{"_index":766,"title":{},"description":{"62":{}}}],["homebrew](https://brew.sh",{"_index":46,"title":{},"description":{"1":{}}}],["host",{"_index":224,"title":{},"description":{"4":{}}}],["hostnam",{"_index":222,"title":{},"description":{"4":{}}}],["hour",{"_index":600,"title":{},"description":{"23":{}}}],["http",{"_index":782,"title":{},"description":{"66":{}}}],["http://www.apache.org/licenses/license-2.0",{"_index":354,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["https://github.com/apache/polaris.git",{"_index":51,"title":{},"description":{"1":{}}}],["https://github.com/apache/spark.git",{"_index":95,"title":{},"description":{"1":{}}}],["https://iceberg.apache.org/docs/latest/configuration/#catalog-properti",{"_index":792,"title":{},"description":{"66":{}}}],["i.",{"_index":685,"title":{},"description":{"27":{},"29":{}}}],["i.d.j.mutableservletcontexthandl",{"_index":131,"title":{},"description":{"2":{}}}],["iam",{"_index":483,"title":{},"description":{"7":{},"9":{}}}],["iceberg",{"_index":274,"title":{"5":{}},"description":{"5":{},"6":{},"7":{},"9":{},"12":{},"14":{},"15":{},"21":{}}}],["iceberg&trad",{"_index":372,"title":{},"description":{"6":{},"7":{},"8":{},"10":{}}}],["iceberg-spark",{"_index":280,"title":{},"description":{"5":{}}}],["iceberg](https://iceberg.apache.org",{"_index":80,"title":{},"description":{"1":{},"5":{}}}],["id",{"_index":298,"title":{},"description":{"5":{},"7":{},"68":{},"80":{}}}],["id</li></ul",{"_index":502,"title":{},"description":{"7":{}}}],["idempot",{"_index":735,"title":{},"description":{"43":{}}}],["ident",{"_index":482,"title":{},"description":{"7":{},"9":{},"16":{},"68":{}}}],["identifi",{"_index":835,"title":{"76":{},"87":{}},"description":{"76":{},"83":{},"87":{},"93":{}}}],["illustr",{"_index":610,"title":{},"description":{"24":{},"26":{}}}],["imag",{"_index":99,"title":{},"description":{"2":{}}}],["immedi",{"_index":841,"title":{},"description":{"77":{}}}],["implement",{"_index":371,"title":{},"description":{"6":{},"27":{},"29":{},"30":{},"75":{},"79":{},"83":{},"93":{}}}],["impli",{"_index":365,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["import",{"_index":433,"title":{},"description":{"7":{},"25":{},"27":{},"30":{}}}],["in-memori",{"_index":143,"title":{},"description":{"3":{},"27":{},"30":{}}}],["includ",{"_index":17,"title":{},"description":{"0":{},"5":{},"7":{},"12":{},"19":{},"25":{},"26":{},"37":{},"68":{},"77":{},"80":{}}}],["incub",{"_index":11,"title":{"28":{}},"description":{"0":{},"6":{},"7":{},"8":{},"11":{},"20":{},"27":{}}}],["incubating).](img/overview.svg",{"_index":381,"title":{},"description":{"6":{}}}],["incubating)](img/example-workflow.svg",{"_index":512,"title":{},"description":{"8":{}}}],["individu",{"_index":613,"title":{},"description":{"25":{}}}],["info",{"_index":128,"title":{},"description":{"2":{}}}],["inform",{"_index":151,"title":{},"description":{"3":{},"4":{},"6":{},"7":{},"9":{},"11":{},"12":{},"13":{},"14":{},"15":{},"16":{},"17":{},"20":{},"27":{},"30":{}}}],["ingest",{"_index":453,"title":{},"description":{"7":{}}}],["initi",{"_index":159,"title":{},"description":{"3":{},"77":{},"80":{}}}],["insert",{"_index":507,"title":{},"description":{"8":{}}}],["insid",{"_index":54,"title":{},"description":{"1":{},"12":{},"18":{},"19":{}}}],["instal",{"_index":44,"title":{},"description":{"1":{}}}],["instanc",{"_index":141,"title":{},"description":{"3":{}}}],["instead",{"_index":590,"title":{},"description":{"22":{},"27":{},"30":{}}}],["integr",{"_index":510,"title":{},"description":{"8":{},"27":{},"30":{}}}],["intend",{"_index":657,"title":{},"description":{"27":{},"28":{}}}],["interact",{"_index":25,"title":{},"description":{"1":{},"4":{},"9":{},"26":{}}}],["interfac",{"_index":27,"title":{},"description":{"1":{},"27":{},"29":{}}}],["intern",{"_index":416,"title":{},"description":{"7":{},"37":{}}}],["introduc",{"_index":383,"title":{},"description":{"7":{}}}],["introduct",{"_index":4,"title":{},"description":{"0":{}}}],["it'",{"_index":870,"title":{},"description":{"83":{},"93":{}}}],["item",{"_index":441,"title":{},"description":{"7":{}}}],["itself",{"_index":55,"title":{},"description":{"1":{},"3":{},"19":{}}}],["jar",{"_index":710,"title":{},"description":{"27":{},"30":{}}}],["java",{"_index":68,"title":{},"description":{"1":{},"27":{},"30":{}}}],["jenv",{"_index":75,"title":{},"description":{"1":{}}}],["jenv](https://www.jenv.b",{"_index":71,"title":{},"description":{"1":{}}}],["job",{"_index":458,"title":{},"description":{"7":{},"22":{}}}],["json",{"_index":850,"title":{},"description":{"79":{},"89":{}}}],["jwt",{"_index":811,"title":{},"description":{"68":{}}}],["keep",{"_index":661,"title":{},"description":{"27":{},"28":{}}}],["key",{"_index":6,"title":{"7":{}},"description":{"0":{},"7":{},"20":{},"27":{},"29":{},"75":{},"79":{},"89":{}}}],["key/valu",{"_index":783,"title":{},"description":{"66":{}}}],["kind",{"_index":363,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["label",{"_index":566,"title":{},"description":{"17":{},"18":{}}}],["languag",{"_index":367,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["last_modified_tim",{"_index":828,"title":{},"description":{"71":{}}}],["later",{"_index":245,"title":{},"description":{"4":{}}}],["latest",{"_index":37,"title":{},"description":{"1":{}}}],["launch",{"_index":106,"title":{},"description":{"2":{},"3":{},"27":{},"30":{}}}],["law",{"_index":357,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["layer",{"_index":401,"title":{},"description":{"7":{}}}],["learn",{"_index":413,"title":{},"description":{"7":{}}}],["legal",{"_index":528,"title":{"10":{}},"description":{}}],["let",{"_index":523,"title":{},"description":{"9":{}}}],["level",{"_index":591,"title":{},"description":{"22":{},"25":{},"70":{}}}],["licens",{"_index":334,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["lightweight",{"_index":98,"title":{},"description":{"2":{}}}],["likewis",{"_index":602,"title":{},"description":{"23":{}}}],["limit",{"_index":370,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["link",{"_index":254,"title":{},"description":{"4":{}}}],["list",{"_index":34,"title":{"66":{},"70":{},"76":{},"87":{}},"description":{"1":{},"19":{},"25":{},"33":{},"38":{},"44":{},"47":{},"52":{},"56":{},"61":{},"62":{},"70":{},"75":{}}}],["listassigneeprincipalrolesforcatalogrol",{"_index":763,"title":{"61":{}},"description":{}}],["listassigneeprincipalsforprincipalrol",{"_index":748,"title":{"52":{}},"description":{}}],["listcatalog",{"_index":716,"title":{"33":{}},"description":{}}],["listcatalogrol",{"_index":756,"title":{"56":{}},"description":{}}],["listcatalogrolesforprincipalrol",{"_index":751,"title":{"53":{}},"description":{}}],["listgrantsforcatalogrol",{"_index":765,"title":{"62":{}},"description":{}}],["listprincip",{"_index":724,"title":{"38":{}},"description":{}}],["listprincipalrol",{"_index":742,"title":{"47":{}},"description":{}}],["listprincipalrolesassign",{"_index":737,"title":{"44":{}},"description":{}}],["load",{"_index":829,"title":{"72":{},"79":{},"89":{}},"description":{"79":{},"89":{}}}],["load_table_with_read_deleg",{"_index":332,"title":{},"description":{"5":{}}}],["local",{"_index":15,"title":{},"description":{"0":{},"1":{},"2":{},"5":{},"27":{},"30":{},"31":{}}}],["localhost:8181",{"_index":219,"title":{},"description":{"4":{},"5":{}}}],["locat",{"_index":197,"title":{"78":{}},"description":{"4":{},"7":{},"9":{},"27":{},"31":{},"66":{},"78":{}}}],["log",{"_index":124,"title":{},"description":{"2":{}}}],["logic",{"_index":427,"title":{},"description":{"7":{},"13":{},"22":{}}}],["lose",{"_index":323,"title":{},"description":{"5":{}}}],["main",{"_index":129,"title":{},"description":{"2":{},"80":{}}}],["make",{"_index":59,"title":{},"description":{"1":{},"80":{}}}],["manag",{"_index":8,"title":{"30":{}},"description":{"0":{},"1":{},"4":{},"5":{},"7":{},"9":{},"11":{},"12":{},"13":{},"14":{},"15":{},"16":{},"17":{},"25":{},"27":{},"30":{}}}],["manger",{"_index":696,"title":{},"description":{"27":{},"30":{}}}],["manifest",{"_index":517,"title":{},"description":{"9":{}}}],["manner",{"_index":522,"title":{},"description":{"9":{}}}],["manual",{"_index":706,"title":{},"description":{"27":{},"30":{}}}],["many-to-mani",{"_index":601,"title":{},"description":{"23":{}}}],["many-to-on",{"_index":588,"title":{},"description":{"22":{},"24":{}}}],["map",{"_index":407,"title":{},"description":{"7":{},"12":{},"14":{},"15":{},"53":{},"75":{}}}],["mark",{"_index":653,"title":{},"description":{"26":{}}}],["match",{"_index":440,"title":{},"description":{"7":{},"79":{},"89":{}}}],["mean",{"_index":144,"title":{},"description":{"3":{},"23":{}}}],["meant",{"_index":690,"title":{},"description":{"27":{},"30":{}}}],["mechan",{"_index":575,"title":{},"description":{"18":{}}}],["messag",{"_index":125,"title":{},"description":{"2":{}}}],["met",{"_index":436,"title":{},"description":{"7":{}}}],["metadata",{"_index":405,"title":{"72":{},"78":{}},"description":{"7":{},"9":{},"27":{},"30":{},"37":{},"72":{},"77":{},"78":{},"79":{},"80":{},"89":{}}}],["metastor",{"_index":688,"title":{"30":{}},"description":{"27":{},"30":{}}}],["metastoremanag",{"_index":689,"title":{},"description":{"27":{},"30":{}}}],["metastoremanager.conf-fil",{"_index":703,"title":{},"description":{"27":{},"30":{}}}],["metastoremanager](https://github.com/apache/polaris/blob/627dc602eb15a3258dcc32babf8def34cf6de0e9/polaris-core/src/main/java/io/polaris/core/persistence/polarismetastoremanager.java#l47",{"_index":699,"title":{},"description":{"27":{},"30":{}}}],["metric",{"_index":873,"title":{"84":{}},"description":{}}],["microsoft",{"_index":498,"title":{},"description":{"7":{}}}],["mind",{"_index":662,"title":{},"description":{"27":{},"28":{}}}],["mode",{"_index":155,"title":{},"description":{"3":{}}}],["model",{"_index":472,"title":{"24":{}},"description":{"7":{},"9":{},"20":{},"24":{},"25":{}}}],["model](access-control.md#rbac-model",{"_index":474,"title":{},"description":{"7":{}}}],["modifi",{"_index":833,"title":{},"description":{"75":{}}}],["more",{"_index":123,"title":{},"description":{"2":{},"3":{},"4":{},"6":{},"7":{},"9":{},"11":{},"12":{},"13":{},"14":{},"15":{},"16":{},"17":{},"18":{},"20":{},"23":{},"27":{},"68":{}}}],["move",{"_index":871,"title":{},"description":{"83":{},"93":{}}}],["multipl",{"_index":72,"title":{"86":{}},"description":{"1":{},"7":{},"17":{},"18":{},"22":{},"23":{}}}],["name",{"_index":408,"title":{"83":{},"93":{}},"description":{"7":{},"8":{},"22":{},"26":{},"80":{}}}],["namespac",{"_index":272,"title":{"13":{},"70":{},"71":{},"72":{},"73":{},"74":{},"75":{},"76":{},"77":{},"78":{},"87":{},"88":{}},"description":{"4":{},"5":{},"7":{},"8":{},"9":{},"13":{},"18":{},"19":{},"21":{},"23":{},"25":{},"26":{},"37":{},"70":{},"71":{},"72":{},"73":{},"75":{},"76":{},"82":{},"83":{},"87":{},"88":{},"92":{},"93":{}}}],["namespace1",{"_index":442,"title":{},"description":{"7":{},"8":{}}}],["namespace1/namespace1a/customers/<fil",{"_index":445,"title":{},"description":{"7":{}}}],["namespace1/namespace1a/orders/<fil",{"_index":446,"title":{},"description":{"7":{}}}],["namespace1a",{"_index":443,"title":{},"description":{"7":{}}}],["namespace_cr",{"_index":633,"title":{},"description":{"25":{}}}],["namespace_drop",{"_index":634,"title":{},"description":{"25":{}}}],["namespace_full_metadata",{"_index":638,"title":{},"description":{"25":{}}}],["namespace_list",{"_index":635,"title":{},"description":{"25":{}}}],["namespace_read_properti",{"_index":636,"title":{},"description":{"25":{}}}],["namespace_write_properti",{"_index":637,"title":{},"description":{"25":{}}}],["namespaces?parent=account",{"_index":822,"title":{},"description":{"70":{}}}],["namespaces?parent=accounting%1ftax",{"_index":825,"title":{},"description":{"70":{}}}],["namespaces](#namespac",{"_index":537,"title":{},"description":{"12":{}}}],["namespaces](overview.md#namespac",{"_index":388,"title":{},"description":{"7":{}}}],["natur",{"_index":573,"title":{},"description":{"18":{}}}],["necessari",{"_index":240,"title":{},"description":{"4":{}}}],["need",{"_index":40,"title":{},"description":{"1":{},"7":{},"17":{},"18":{},"25":{},"77":{}}}],["nest",{"_index":387,"title":{},"description":{"7":{},"13":{},"25":{}}}],["new",{"_index":193,"title":{"83":{},"93":{}},"description":{"4":{},"7":{},"34":{},"43":{},"57":{},"63":{},"80":{}}}],["non-empti",{"_index":848,"title":{},"description":{"79":{},"89":{}}}],["normal",{"_index":713,"title":{},"description":{"27":{},"30":{}}}],["notabl",{"_index":663,"title":{},"description":{"27":{},"29":{}}}],["note",{"_index":164,"title":{},"description":{"3":{},"4":{},"5":{},"23":{}}}],["notic",{"_index":341,"title":{"10":{}},"description":{"6":{},"11":{},"20":{},"27":{}}}],["notif",{"_index":876,"title":{"85":{}},"description":{}}],["now",{"_index":250,"title":{},"description":{"4":{},"5":{}}}],["o.e.j.s.handler.contexthandl",{"_index":130,"title":{},"description":{"2":{}}}],["o.e.j.server.abstractconnector",{"_index":132,"title":{},"description":{"2":{}}}],["o.eclipse.jetty.server.serv",{"_index":135,"title":{},"description":{"2":{}}}],["oauth2",{"_index":665,"title":{"67":{},"68":{}},"description":{"27":{},"29":{},"68":{}}}],["oauth](https://oauth.net/2",{"_index":672,"title":{},"description":{"27":{},"29":{}}}],["object",{"_index":175,"title":{"21":{}},"description":{"4":{},"7":{},"20":{},"21":{},"22":{},"23":{},"25":{}}}],["obtain",{"_index":352,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["on",{"_index":338,"title":{},"description":{"6":{},"7":{},"11":{},"16":{},"17":{},"18":{},"20":{},"22":{},"23":{},"27":{},"68":{},"83":{},"93":{}}}],["onc",{"_index":58,"title":{},"description":{"1":{},"2":{},"4":{},"5":{},"27":{},"30":{}}}],["op",{"_index":331,"title":{},"description":{"5":{}}}],["open",{"_index":373,"title":{},"description":{"6":{}}}],["openjdk@21",{"_index":76,"title":{},"description":{"1":{}}}],["oper",{"_index":412,"title":{"86":{}},"description":{"7":{},"23":{},"25":{},"27":{},"30":{},"37":{},"77":{}}}],["option",{"_index":227,"title":{"70":{}},"description":{"4":{},"25":{},"27":{},"29":{},"70":{},"71":{}}}],["optional)</li></ul",{"_index":496,"title":{},"description":{"7":{}}}],["order",{"_index":258,"title":{},"description":{"4":{},"7":{},"19":{},"27":{},"30":{}}}],["org.apache.iceberg.exceptions.forbiddenexcept",{"_index":324,"title":{},"description":{"5":{}}}],["org.apache.iceberg:iceberg-spark-runtime-3.5_2.12:1.5.2,org.apache.hadoop:hadoop-aws:3.4.0",{"_index":286,"title":{},"description":{"5":{}}}],["organ",{"_index":178,"title":{},"description":{"4":{},"7":{}}}],["otherwis",{"_index":852,"title":{},"description":{"79":{},"89":{}}}],["out",{"_index":92,"title":{},"description":{"1":{}}}],["outlin",{"_index":664,"title":{},"description":{"27":{},"29":{}}}],["output",{"_index":119,"title":{},"description":{"2":{}}}],["overrid",{"_index":785,"title":{},"description":{"66":{},"79":{},"89":{}}}],["overview",{"_index":333,"title":{"6":{}},"description":{"6":{}}}],["ownership",{"_index":348,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["packag",{"_index":281,"title":{},"description":{"5":{}}}],["page",{"_index":535,"title":{},"description":{"11":{}}}],["paid",{"_index":826,"title":{},"description":{"70":{}}}],["pair",{"_index":449,"title":{},"description":{"7":{},"66":{},"75":{}}}],["paramet",{"_index":772,"title":{},"description":{"64":{}}}],["parent",{"_index":776,"title":{"70":{}},"description":{"64":{},"70":{}}}],["part",{"_index":857,"title":{},"description":{"80":{}}}],["particular",{"_index":596,"title":{},"description":{"23":{}}}],["partit",{"_index":519,"title":{},"description":{"9":{}}}],["pass",{"_index":851,"title":{},"description":{"79":{},"89":{}}}],["path/to/jar/polaris-service-all.jar",{"_index":711,"title":{},"description":{"27":{},"30":{}}}],["perform",{"_index":410,"title":{},"description":{"7":{},"8":{},"23":{},"25":{},"27":{},"30":{}}}],["period",{"_index":802,"title":{},"description":{"68":{}}}],["permiss",{"_index":369,"title":{},"description":{"6":{},"11":{},"20":{},"22":{},"23":{},"26":{},"27":{}}}],["permit",{"_index":606,"title":{},"description":{"23":{}}}],["persist",{"_index":698,"title":{},"description":{"27":{},"30":{}}}],["persistence.xml",{"_index":704,"title":{},"description":{"27":{},"30":{}}}],["persona",{"_index":568,"title":{},"description":{"17":{}}}],["pipelin",{"_index":457,"title":{},"description":{"7":{}}}],["plan",{"_index":53,"title":{},"description":{"1":{}}}],["pleas",{"_index":228,"title":{},"description":{"4":{}}}],["point",{"_index":137,"title":{},"description":{"2":{},"5":{},"7":{},"27":{},"30":{}}}],["pointer",{"_index":406,"title":{},"description":{"7":{}}}],["polari",{"_index":10,"title":{"2":{},"3":{},"5":{},"11":{},"27":{},"28":{}},"description":{"0":{},"1":{},"2":{},"3":{},"4":{},"5":{},"6":{},"7":{},"8":{},"9":{},"11":{},"12":{},"13":{},"14":{},"15":{},"16":{},"17":{},"18":{},"19":{},"20":{},"21":{},"22":{},"23":{},"24":{},"25":{},"26":{},"27":{},"28":{},"29":{},"30":{},"31":{},"33":{},"42":{},"51":{}}}],["polaris-manag",{"_index":277,"title":{},"description":{"5":{}}}],["polaris-polari",{"_index":111,"title":{},"description":{"2":{}}}],["polaris-server.yml",{"_index":656,"title":{},"description":{"27":{},"28":{},"30":{}}}],["polaris.](img/rbac-example.svg",{"_index":655,"title":{},"description":{"26":{}}}],["polaris.](img/rbac-model.svg",{"_index":611,"title":{},"description":{"24":{}}}],["pool",{"_index":788,"title":{},"description":{"66":{}}}],["port",{"_index":223,"title":{},"description":{"4":{}}}],["power",{"_index":463,"title":{},"description":{"7":{}}}],["practic",{"_index":660,"title":{},"description":{"27":{},"28":{}}}],["prefix",{"_index":78,"title":{},"description":{"1":{}}}],["prepar",{"_index":707,"title":{},"description":{"27":{},"30":{},"77":{}}}],["prerequisit",{"_index":21,"title":{"1":{}},"description":{"1":{}}}],["prerequisites](#building-and-deploying-polari",{"_index":103,"title":{},"description":{"2":{}}}],["present",{"_index":777,"title":{},"description":{"64":{}}}],["princip",{"_index":156,"title":{"16":{},"17":{},"22":{}},"description":{"3":{},"4":{},"5":{},"7":{},"8":{},"9":{},"16":{},"17":{},"18":{},"19":{},"20":{},"22":{},"23":{},"24":{},"25":{},"26":{},"37":{},"38":{},"39":{},"40":{},"41":{},"42":{},"44":{},"45":{},"46":{},"47":{},"48":{},"49":{},"51":{},"52":{},"53":{},"54":{},"55":{},"64":{}}}],["principal'",{"_index":732,"title":{},"description":{"43":{}}}],["principal-rol",{"_index":236,"title":{},"description":{"4":{},"47":{},"48":{}}}],["principal-roles/{principalrolenam",{"_index":745,"title":{},"description":{"49":{},"50":{},"51":{}}}],["principal-roles/{principalrolename}/catalog-roles/{catalognam",{"_index":752,"title":{},"description":{"53":{},"54":{}}}],["principal-roles/{principalrolename}/catalog-roles/{catalogname}/{catalogrolenam",{"_index":755,"title":{},"description":{"55":{}}}],["principal-roles/{principalrolename}/princip",{"_index":750,"title":{},"description":{"52":{}}}],["principal](./entities.md#princip",{"_index":232,"title":{},"description":{"4":{}}}],["principalrol",{"_index":327,"title":{},"description":{"5":{},"50":{},"61":{}}}],["principals/{principalnam",{"_index":727,"title":{},"description":{"40":{},"41":{},"42":{}}}],["principals/{principalname}/principal-rol",{"_index":738,"title":{},"description":{"44":{},"45":{}}}],["principals/{principalname}/principal-roles/{principalrolenam",{"_index":741,"title":{},"description":{"46":{}}}],["principals/{principalname}/rot",{"_index":736,"title":{},"description":{"43":{}}}],["principals](#princip",{"_index":567,"title":{},"description":{"17":{}}}],["privileg",{"_index":231,"title":{"19":{},"25":{}},"description":{"4":{},"5":{},"7":{},"8":{},"9":{},"19":{},"20":{},"22":{},"23":{},"24":{},"25":{}}}],["privileges:<ul><li>catalog_manage_metadata</li><li>table_full_metadata</li><li>namespace_full_metadata</li><li>view_full_metadata</li><li>table_write_data</li><li>table_read_data</li><li>catalog_read_properties</li><li>catalog_write_properties</li></ul",{"_index":641,"title":{},"description":{"25":{}}}],["privileges](#privileg",{"_index":574,"title":{},"description":{"18":{}}}],["privileges](../regtests/client/python/docs/catalogprivilege.md",{"_index":586,"title":{},"description":{"19":{}}}],["privileges](../regtests/client/python/docs/namespaceprivilege.md",{"_index":585,"title":{},"description":{"19":{}}}],["privileges](../regtests/client/python/docs/tableprivilege.md",{"_index":583,"title":{},"description":{"19":{}}}],["privileges](../regtests/client/python/docs/viewprivilege.md",{"_index":584,"title":{},"description":{"19":{}}}],["privileges](./entities.md#privileg",{"_index":261,"title":{},"description":{"4":{}}}],["proceed",{"_index":30,"title":{},"description":{"1":{}}}],["process",{"_index":101,"title":{"84":{}},"description":{"2":{},"7":{},"9":{}}}],["product",{"_index":152,"title":{"27":{},"28":{}},"description":{"3":{},"27":{},"28":{},"30":{},"31":{}}}],["properti",{"_index":630,"title":{"72":{},"75":{}},"description":{"25":{},"66":{},"71":{},"72":{},"75":{}}}],["properties](https://iceberg.apache.org/docs/nightly/configuration/#table-properti",{"_index":619,"title":{},"description":{"25":{}}}],["protocol",{"_index":374,"title":{},"description":{"6":{}}}],["provid",{"_index":195,"title":{"70":{}},"description":{"4":{},"5":{},"6":{},"7":{},"12":{},"20":{},"66":{},"70":{}}}],["purg",{"_index":708,"title":{},"description":{"27":{},"30":{},"37":{}}}],["purpos",{"_index":451,"title":{},"description":{"7":{},"16":{},"68":{}}}],["queri",{"_index":378,"title":{},"description":{"6":{},"7":{},"9":{}}}],["quick",{"_index":0,"title":{"0":{}},"description":{}}],["quickstart_catalog",{"_index":192,"title":{},"description":{"4":{},"5":{}}}],["quickstart_catalog_rol",{"_index":239,"title":{},"description":{"4":{},"5":{}}}],["quickstart_namespac",{"_index":311,"title":{},"description":{"5":{}}}],["quickstart_namespace.schema",{"_index":312,"title":{},"description":{"5":{}}}],["quickstart_t",{"_index":314,"title":{},"description":{"5":{}}}],["quickstart_table\").show(fals",{"_index":321,"title":{},"description":{"5":{}}}],["quickstart_us",{"_index":235,"title":{},"description":{"4":{},"5":{}}}],["quickstart_user_rol",{"_index":237,"title":{},"description":{"4":{}}}],["rbac",{"_index":471,"title":{"24":{},"26":{}},"description":{"7":{},"9":{},"20":{},"24":{},"26":{}}}],["read",{"_index":201,"title":{},"description":{"4":{},"6":{},"7":{},"8":{},"23":{},"25":{}}}],["read+writ",{"_index":624,"title":{},"description":{"25":{}}}],["read-onli",{"_index":424,"title":{},"description":{"7":{},"23":{},"25":{},"26":{}}}],["reader",{"_index":609,"title":{},"description":{"23":{},"26":{}}}],["realm",{"_index":161,"title":{},"description":{"3":{},"27":{},"29":{}}}],["realmcontextresolv",{"_index":681,"title":{},"description":{"27":{},"29":{}}}],["realmcontextresolver](https://github.com/apache/polaris/blob/7ce86f10a68a3b56aed766235c88d6027c0de038/polaris-service/src/main/java/io/polaris/service/context/realmcontextresolver.java",{"_index":687,"title":{},"description":{"27":{},"29":{}}}],["receiv",{"_index":578,"title":{},"description":{"19":{},"25":{}}}],["recommend",{"_index":70,"title":{},"description":{"1":{}}}],["ref",{"_index":863,"title":{},"description":{"80":{}}}],["ref'",{"_index":861,"title":{},"description":{"80":{}}}],["refer",{"_index":86,"title":{},"description":{"1":{},"4":{},"13":{}}}],["reflect",{"_index":669,"title":{},"description":{"27":{},"29":{}}}],["refresh",{"_index":800,"title":{},"description":{"68":{}}}],["regard",{"_index":346,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["regist",{"_index":430,"title":{"78":{}},"description":{"7":{},"9":{},"10":{},"22":{},"25":{},"78":{}}}],["relat",{"_index":547,"title":{},"description":{"12":{}}}],["relationship",{"_index":487,"title":{},"description":{"7":{},"22":{},"23":{},"24":{}}}],["releas",{"_index":425,"title":{},"description":{"7":{}}}],["relev",{"_index":33,"title":{},"description":{"1":{},"2":{},"27":{},"29":{}}}],["remot",{"_index":694,"title":{},"description":{"27":{},"30":{}}}],["remov",{"_index":478,"title":{"75":{}},"description":{"7":{},"27":{},"29":{},"42":{},"46":{},"51":{},"55":{},"75":{},"81":{},"91":{}}}],["renam",{"_index":869,"title":{"83":{},"93":{}},"description":{"83":{},"93":{}}}],["replac",{"_index":297,"title":{"90":{}},"description":{"5":{},"66":{}}}],["repo",{"_index":49,"title":{},"description":{"1":{}}}],["report",{"_index":874,"title":{"84":{}},"description":{}}],["repositori",{"_index":42,"title":{},"description":{"1":{}}}],["repres",{"_index":466,"title":{},"description":{"7":{},"16":{}}}],["request",{"_index":803,"title":{},"description":{"68":{},"75":{},"79":{},"89":{},"92":{}}}],["request'",{"_index":815,"title":{},"description":{"68":{}}}],["requir",{"_index":356,"title":{},"description":{"6":{},"9":{},"11":{},"20":{},"27":{},"75":{},"80":{},"83":{},"93":{}}}],["resembl",{"_index":126,"title":{},"description":{"2":{}}}],["resid",{"_index":548,"title":{},"description":{"12":{},"13":{},"18":{}}}],["resolv",{"_index":682,"title":{},"description":{"27":{},"29":{}}}],["resourc",{"_index":207,"title":{},"description":{"4":{},"7":{},"9":{},"20":{},"22":{},"23":{},"24":{},"26":{},"64":{}}}],["respons",{"_index":569,"title":{},"description":{"17":{},"43":{},"73":{},"79":{},"82":{},"89":{},"92":{}}}],["rest",{"_index":83,"title":{},"description":{"1":{},"5":{},"6":{},"12":{},"13":{},"14":{},"15":{},"16":{},"17":{},"66":{}}}],["rest-compat",{"_index":377,"title":{},"description":{"6":{},"7":{}}}],["result",{"_index":476,"title":{},"description":{"7":{}}}],["retain",{"_index":520,"title":{},"description":{"9":{},"64":{}}}],["return",{"_index":244,"title":{},"description":{"4":{},"43":{},"70":{},"72":{},"76":{},"77":{},"87":{},"92":{}}}],["revoc",{"_index":774,"title":{},"description":{"64":{}}}],["revok",{"_index":322,"title":{},"description":{"5":{},"23":{},"25":{},"64":{}}}],["revokecatalogrolefromprincipalrol",{"_index":754,"title":{"55":{}},"description":{}}],["revokegrantfromcatalogrol",{"_index":769,"title":{"64":{}},"description":{}}],["revokeprincipalrol",{"_index":740,"title":{"46":{}},"description":{}}],["rfc",{"_index":853,"title":{},"description":{"79":{},"89":{}}}],["right",{"_index":652,"title":{},"description":{"26":{}}}],["role",{"_index":198,"title":{"17":{},"18":{},"22":{},"23":{}},"description":{"4":{},"7":{},"9":{},"17":{},"18":{},"19":{},"20":{},"22":{},"23":{},"24":{},"25":{},"26":{},"37":{},"44":{},"45":{},"46":{},"47":{},"48":{},"49":{},"51":{},"52":{},"53":{},"54":{},"55":{},"56":{},"57":{},"58":{},"59":{},"60":{},"61":{},"62":{},"63":{},"64":{}}}],["role-arn",{"_index":190,"title":{},"description":{"4":{}}}],["role-bas",{"_index":469,"title":{},"description":{"7":{},"9":{},"20":{}}}],["role](./entities.md#catalog-rol",{"_index":253,"title":{},"description":{"4":{}}}],["role](./entities.md#principal-rol",{"_index":252,"title":{},"description":{"4":{}}}],["role](./img/quickstart/privilege-illustration-2.png",{"_index":268,"title":{},"description":{"4":{}}}],["role](access-control.md#catalog-rol",{"_index":477,"title":{},"description":{"7":{}}}],["role](access-control.md#principal-rol",{"_index":468,"title":{},"description":{"7":{}}}],["role_arn",{"_index":191,"title":{},"description":{"4":{}}}],["roles](#catalog-rol",{"_index":576,"title":{},"description":{"19":{}}}],["roles](#principal-rol",{"_index":564,"title":{},"description":{"16":{},"18":{}}}],["root",{"_index":149,"title":{},"description":{"3":{},"5":{}}}],["rotat",{"_index":731,"title":{},"description":{"43":{}}}],["rotatecredenti",{"_index":730,"title":{"43":{}},"description":{}}],["rout",{"_index":781,"title":{},"description":{"66":{},"77":{},"80":{}}}],["run",{"_index":60,"title":{},"description":{"1":{},"2":{},"4":{},"5":{},"7":{},"9":{},"22":{},"27":{},"30":{}}}],["runapp",{"_index":117,"title":{},"description":{"2":{}}}],["s3",{"_index":187,"title":{},"description":{"4":{},"7":{},"12":{}}}],["same",{"_index":271,"title":{},"description":{"4":{},"7":{},"17":{},"18":{},"22":{},"23":{},"68":{}}}],["sampl",{"_index":385,"title":{},"description":{"7":{}}}],["satisfi",{"_index":32,"title":{},"description":{"1":{},"2":{}}}],["schema",{"_index":518,"title":{},"description":{"9":{}}}],["scienc",{"_index":595,"title":{},"description":{"22":{}}}],["scientist",{"_index":654,"title":{},"description":{"26":{}}}],["scope",{"_index":580,"title":{},"description":{"19":{}}}],["secret",{"_index":299,"title":{},"description":{"5":{},"7":{},"68":{}}}],["section",{"_index":233,"title":{},"description":{"4":{},"7":{},"9":{},"20":{},"25":{}}}],["secur",{"_index":376,"title":{"9":{},"21":{},"29":{}},"description":{"6":{},"7":{},"9":{},"20":{},"21":{},"22":{},"27":{},"29":{},"30":{}}}],["see",{"_index":118,"title":{},"description":{"2":{},"3":{},"4":{},"6":{},"7":{},"9":{},"11":{},"12":{},"13":{},"14":{},"15":{},"16":{},"17":{},"19":{},"20":{},"27":{}}}],["select",{"_index":819,"title":{},"description":{"70":{}}}],["send",{"_index":814,"title":{"84":{},"85":{}},"description":{"68":{},"77":{}}}],["serv",{"_index":3,"title":{},"description":{"0":{}}}],["server",{"_index":136,"title":{},"description":{"2":{},"5":{},"27":{},"30":{},"66":{},"71":{},"75":{},"83":{},"93":{}}}],["servic",{"_index":180,"title":{},"description":{"4":{},"7":{},"8":{},"9":{},"16":{},"18":{},"20":{},"22":{},"23":{},"24":{},"25":{},"26":{},"27":{},"29":{},"30":{},"33":{},"77":{}}}],["service(",{"_index":684,"title":{},"description":{"27":{},"29":{}}}],["session",{"_index":307,"title":{},"description":{"5":{},"68":{}}}],["set",{"_index":165,"title":{"66":{},"75":{}},"description":{"3":{},"4":{},"7":{},"12":{},"23":{},"25":{},"27":{},"29":{},"66":{},"71":{},"75":{},"77":{},"80":{}}}],["setcurrentschemaupd",{"_index":846,"title":{},"description":{"77":{},"80":{}}}],["sever",{"_index":5,"title":{},"description":{"0":{},"27":{},"28":{}}}],["shell",{"_index":47,"title":{},"description":{"1":{},"2":{},"3":{},"4":{},"5":{}}}],["short-liv",{"_index":622,"title":{},"description":{"25":{}}}],["show",{"_index":393,"title":{},"description":{"7":{},"8":{},"22":{},"24":{},"26":{}}}],["shown",{"_index":389,"title":{},"description":{"7":{}}}],["shut",{"_index":146,"title":{},"description":{"3":{}}}],["sign",{"_index":645,"title":{},"description":{"26":{}}}],["silver",{"_index":648,"title":{},"description":{"26":{}}}],["similar",{"_index":301,"title":{},"description":{"5":{}}}],["singl",{"_index":438,"title":{},"description":{"7":{},"22":{}}}],["size",{"_index":787,"title":{},"description":{"66":{}}}],["snapshot",{"_index":862,"title":{},"description":{"80":{}}}],["snowflak",{"_index":419,"title":{},"description":{"7":{},"8":{},"26":{}}}],["snowflake-manag",{"_index":431,"title":{},"description":{"7":{}}}],["snowpip",{"_index":646,"title":{},"description":{"26":{}}}],["softwar",{"_index":335,"title":{},"description":{"6":{},"10":{},"11":{},"20":{},"27":{}}}],["somewher",{"_index":218,"title":{},"description":{"4":{}}}],["sourc",{"_index":61,"title":{},"description":{"1":{},"6":{}}}],["spark",{"_index":88,"title":{},"description":{"1":{},"5":{},"7":{}}}],["spark&trad",{"_index":20,"title":{},"description":{"0":{},"7":{},"8":{},"10":{},"26":{}}}],["spark.sql",{"_index":313,"title":{},"description":{"5":{}}}],["spark.sql(\"creat",{"_index":309,"title":{},"description":{"5":{}}}],["spark.sql(\"insert",{"_index":317,"title":{},"description":{"5":{}}}],["spark.sql(\"select",{"_index":320,"title":{},"description":{"5":{}}}],["spark.sql(\"us",{"_index":308,"title":{},"description":{"5":{}}}],["spark.sql.catalog.quickstart_catalog.catalog-impl=org.apache.iceberg.rest.restcatalog",{"_index":292,"title":{},"description":{"5":{}}}],["spark.sql.catalog.quickstart_catalog.credential='xxxx:yyyi",{"_index":294,"title":{},"description":{"5":{}}}],["spark.sql.catalog.quickstart_catalog.header.x-iceberg-access-delegation=vended-credenti",{"_index":290,"title":{},"description":{"5":{}}}],["spark.sql.catalog.quickstart_catalog.scope='principal_role:al",{"_index":295,"title":{},"description":{"5":{}}}],["spark.sql.catalog.quickstart_catalog.token-refresh-enabled=tru",{"_index":296,"title":{},"description":{"5":{}}}],["spark.sql.catalog.quickstart_catalog.uri=http://localhost:8181/api/catalog",{"_index":293,"title":{},"description":{"5":{}}}],["spark.sql.catalog.quickstart_catalog.warehouse=quickstart_catalog",{"_index":289,"title":{},"description":{"5":{}}}],["spark.sql.catalog.quickstart_catalog=org.apache.iceberg.spark.sparkcatalog",{"_index":291,"title":{},"description":{"5":{}}}],["spark.sql.extensions=org.apache.iceberg.spark.extensions.icebergsparksessionextens",{"_index":288,"title":{},"description":{"5":{}}}],["spark](https://spark.apache.org",{"_index":28,"title":{},"description":{"1":{},"5":{}}}],["specif",{"_index":366,"title":{},"description":{"6":{},"11":{},"20":{},"27":{},"64":{},"68":{}}}],["specifi",{"_index":220,"title":{},"description":{"4":{},"22":{},"23":{},"25":{},"27":{},"29":{},"30":{},"64":{},"75":{}}}],["specification](https://iceberg.apache.org/spec/#overview",{"_index":402,"title":{},"description":{"7":{}}}],["stage-cr",{"_index":839,"title":{},"description":{"77":{},"80":{}}}],["standalon",{"_index":100,"title":{},"description":{"2":{}}}],["start",{"_index":1,"title":{"0":{}},"description":{"1":{},"2":{},"5":{},"70":{},"77":{},"80":{}}}],["startup",{"_index":160,"title":{},"description":{"3":{}}}],["state",{"_index":532,"title":{},"description":{"10":{},"77":{}}}],["stdout",{"_index":158,"title":{},"description":{"3":{}}}],["storag",{"_index":209,"title":{},"description":{"4":{},"7":{},"9":{},"12":{},"25":{},"27":{},"31":{}}}],["storage-typ",{"_index":186,"title":{},"description":{"4":{}}}],["store",{"_index":142,"title":{},"description":{"3":{},"4":{},"5":{},"7":{},"9":{},"27":{},"30":{},"66":{},"72":{}}}],["stream",{"_index":455,"title":{},"description":{"7":{},"26":{}}}],["string",{"_index":316,"title":{},"description":{"5":{}}}],["structur",{"_index":395,"title":{},"description":{"7":{}}}],["structure.](img/sample-catalog-structure.svg",{"_index":394,"title":{},"description":{"7":{}}}],["structure](overview.md#catalog",{"_index":386,"title":{},"description":{"7":{}}}],["sub",{"_index":812,"title":{},"description":{"68":{}}}],["subject",{"_index":807,"title":{},"description":{"68":{}}}],["subresourc",{"_index":775,"title":{},"description":{"64":{}}}],["subsequ",{"_index":804,"title":{},"description":{"68":{},"77":{},"79":{},"89":{}}}],["subset",{"_index":770,"title":{},"description":{"64":{}}}],["successfulli",{"_index":243,"title":{},"description":{"4":{}}}],["such",{"_index":211,"title":{},"description":{"4":{},"7":{},"13":{},"18":{},"23":{},"27":{},"30":{},"71":{}}}],["suitabl",{"_index":691,"title":{},"description":{"27":{},"30":{}}}],["superset",{"_index":771,"title":{},"description":{"64":{}}}],["suppli",{"_index":489,"title":{},"description":{"7":{}}}],["support",{"_index":82,"title":{},"description":{"1":{},"4":{},"7":{},"19":{},"22":{},"23":{},"24":{},"75":{},"83":{},"93":{}}}],["sure",{"_index":31,"title":{},"description":{"1":{},"2":{},"3":{},"4":{},"5":{},"27":{},"30":{}}}],["symmetric](https://github.com/apache/polaris/blob/b482617bf8cc508b37dbedf3ebc81a9408160a5e/polaris-service/src/main/java/io/polaris/service/auth/jwtsymmetrickeybroker.java#l23",{"_index":678,"title":{},"description":{"27":{},"29":{}}}],["sync",{"_index":423,"title":{},"description":{"7":{}}}],["system",{"_index":526,"title":{},"description":{"9":{},"13":{},"27":{},"31":{}}}],["tabl",{"_index":305,"title":{"14":{},"76":{},"77":{},"78":{},"79":{},"80":{},"81":{},"82":{},"83":{},"85":{},"86":{}},"description":{"5":{},"6":{},"7":{},"8":{},"9":{},"14":{},"18":{},"19":{},"21":{},"22":{},"23":{},"25":{},"26":{},"37":{},"70":{},"76":{},"77":{},"78":{},"79":{},"80":{},"81":{},"82":{},"83":{}}}],["table'",{"_index":409,"title":{},"description":{"7":{},"79":{}}}],["table1",{"_index":505,"title":{},"description":{"8":{}}}],["table_cr",{"_index":615,"title":{},"description":{"25":{}}}],["table_drop",{"_index":616,"title":{},"description":{"25":{}}}],["table_full_metadata",{"_index":625,"title":{},"description":{"25":{}}}],["table_list",{"_index":617,"title":{},"description":{"25":{}}}],["table_read_data",{"_index":621,"title":{},"description":{"25":{}}}],["table_read_properti",{"_index":618,"title":{},"description":{"25":{}}}],["table_write_data",{"_index":623,"title":{},"description":{"25":{}}}],["table_write_properti",{"_index":620,"title":{},"description":{"25":{}}}],["tables](#t",{"_index":538,"title":{},"description":{"12":{},"13":{}}}],["tables](./entities.md#t",{"_index":176,"title":{},"description":{"4":{}}}],["tables](https://iceberg.apache.org/docs/nightly/configur",{"_index":557,"title":{},"description":{"14":{}}}],["take",{"_index":598,"title":{},"description":{"23":{}}}],["target",{"_index":749,"title":{},"description":{"52":{},"61":{}}}],["task",{"_index":403,"title":{},"description":{"7":{}}}],["tax",{"_index":823,"title":{},"description":{"70":{}}}],["team",{"_index":465,"title":{},"description":{"7":{}}}],["temporari",{"_index":514,"title":{},"description":{"9":{}}}],["tenant",{"_index":501,"title":{},"description":{"7":{}}}],["test",{"_index":546,"title":{},"description":{"12":{},"27":{},"28":{},"30":{}}}],["testinlinebearertokenpolarisauthent",{"_index":673,"title":{},"description":{"27":{},"29":{}}}],["those",{"_index":206,"title":{},"description":{"4":{},"5":{},"22":{}}}],["three",{"_index":797,"title":{},"description":{"68":{}}}],["time",{"_index":120,"title":{},"description":{"2":{},"4":{},"5":{}}}],["togeth",{"_index":267,"title":{},"description":{"4":{},"7":{},"22":{}}}],["token",{"_index":670,"title":{"68":{}},"description":{"27":{},"29":{},"68":{},"79":{},"89":{}}}],["tokenbrok",{"_index":668,"title":{},"description":{"27":{},"29":{}}}],["top-level",{"_index":174,"title":{},"description":{"4":{},"7":{},"12":{},"70":{}}}],["trademark",{"_index":530,"title":{},"description":{"10":{}}}],["transact",{"_index":837,"title":{},"description":{"77":{},"80":{}}}],["transform",{"_index":459,"title":{},"description":{"7":{}}}],["translat",{"_index":821,"title":{},"description":{"70":{}}}],["trino",{"_index":460,"title":{},"description":{"7":{}}}],["true",{"_index":773,"title":{},"description":{"64":{},"77":{},"80":{}}}],["trust",{"_index":486,"title":{},"description":{"7":{}}}],["turn",{"_index":579,"title":{},"description":{"19":{},"26":{}}}],["tutori",{"_index":139,"title":{},"description":{"3":{}}}],["two",{"_index":415,"title":{},"description":{"7":{},"9":{},"66":{},"80":{}}}],["type",{"_index":210,"title":{},"description":{"4":{},"7":{},"9":{},"12":{},"27":{},"31":{},"68":{},"79":{},"89":{}}}],["type_",{"_index":543,"title":{},"description":{"12":{}}}],["ul><li>default",{"_index":491,"title":{},"description":{"7":{}}}],["uncom",{"_index":674,"title":{},"description":{"27":{},"29":{}}}],["under",{"_index":179,"title":{},"description":{"4":{},"6":{},"7":{},"8":{},"11":{},"20":{},"27":{},"76":{},"87":{}}}],["underneath",{"_index":817,"title":{"70":{},"76":{},"87":{}},"description":{}}],["understand",{"_index":587,"title":{},"description":{"20":{}}}],["uniqu",{"_index":562,"title":{},"description":{"16":{}}}],["unit",{"_index":531,"title":{},"description":{"10":{}}}],["unless",{"_index":355,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["unmanag",{"_index":511,"title":{},"description":{"8":{}}}],["unsecur",{"_index":810,"title":{},"description":{"68":{}}}],["up",{"_index":110,"title":{},"description":{"2":{},"23":{},"26":{}}}],["updat",{"_index":303,"title":{"80":{},"86":{}},"description":{"5":{},"7":{},"23":{},"36":{},"41":{},"50":{},"59":{},"75":{},"80":{},"90":{}}}],["updatecatalog",{"_index":720,"title":{"36":{}},"description":{}}],["updatecatalogrol",{"_index":761,"title":{"59":{}},"description":{}}],["updateprincip",{"_index":728,"title":{"41":{}},"description":{}}],["updateprincipalrol",{"_index":746,"title":{"50":{}},"description":{}}],["urn:ietf:params:oauth:token-type:jwt=<jwt-token",{"_index":855,"title":{},"description":{"79":{},"89":{}}}],["us",{"_index":19,"title":{"5":{},"68":{},"78":{}},"description":{"0":{},"1":{},"2":{},"3":{},"4":{},"5":{},"6":{},"7":{},"8":{},"9":{},"11":{},"12":{},"16":{},"20":{},"22":{},"24":{},"25":{},"26":{},"27":{},"29":{},"30":{},"31":{},"66":{},"68":{},"70":{},"77":{},"78":{},"79":{},"80":{},"89":{}}}],["usag",{"_index":153,"title":{},"description":{"3":{},"27":{},"30":{}}}],["user",{"_index":563,"title":{},"description":{"16":{},"18":{},"26":{},"68":{}}}],["user'",{"_index":734,"title":{},"description":{"43":{}}}],["v1/config",{"_index":793,"title":{},"description":{"66":{}}}],["v1/oauth/token",{"_index":816,"title":{},"description":{"68":{}}}],["v1/{prefix}/namespac",{"_index":827,"title":{},"description":{"70":{},"71":{}}}],["v1/{prefix}/namespaces/{namespac",{"_index":830,"title":{},"description":{"72":{},"73":{},"74":{}}}],["v1/{prefix}/namespaces/{namespace}/properti",{"_index":834,"title":{},"description":{"75":{}}}],["v1/{prefix}/namespaces/{namespace}/regist",{"_index":847,"title":{},"description":{"78":{}}}],["v1/{prefix}/namespaces/{namespace}/t",{"_index":836,"title":{},"description":{"76":{},"77":{}}}],["v1/{prefix}/namespaces/{namespace}/tables/{t",{"_index":856,"title":{},"description":{"79":{},"80":{},"81":{},"82":{}}}],["v1/{prefix}/namespaces/{namespace}/tables/{table}/metr",{"_index":875,"title":{},"description":{"84":{}}}],["v1/{prefix}/namespaces/{namespace}/tables/{table}/notif",{"_index":877,"title":{},"description":{"85":{}}}],["v1/{prefix}/namespaces/{namespace}/view",{"_index":879,"title":{},"description":{"87":{},"88":{}}}],["v1/{prefix}/namespaces/{namespace}/views/{view",{"_index":881,"title":{},"description":{"89":{},"90":{},"91":{},"92":{}}}],["v1/{prefix}/tables/renam",{"_index":872,"title":{},"description":{"83":{}}}],["v1/{prefix}/transactions/commit",{"_index":878,"title":{},"description":{"86":{}}}],["v1/{prefix}/views/renam",{"_index":882,"title":{},"description":{"93":{}}}],["valid",{"_index":544,"title":{},"description":{"12":{},"13":{},"80":{},"83":{},"93":{}}}],["valu",{"_index":318,"title":{},"description":{"5":{},"7":{},"8":{},"75":{},"80":{}}}],["variabl",{"_index":167,"title":{},"description":{"3":{}}}],["variou",{"_index":536,"title":{},"description":{"11":{},"12":{}}}],["vend",{"_index":513,"title":{},"description":{"9":{}}}],["version",{"_index":73,"title":{},"description":{"1":{},"6":{},"7":{},"11":{},"20":{},"27":{}}}],["version](https://mvnrepository.com/artifact/org.apache.iceberg/iceberg-spark",{"_index":282,"title":{},"description":{"5":{}}}],["via",{"_index":23,"title":{},"description":{"1":{},"2":{},"4":{},"7":{}}}],["view",{"_index":559,"title":{"15":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{}},"description":{"15":{},"19":{},"21":{},"25":{},"87":{},"88":{},"89":{},"90":{},"91":{},"92":{},"93":{}}}],["view'",{"_index":880,"title":{},"description":{"89":{}}}],["view_creat",{"_index":626,"title":{},"description":{"25":{}}}],["view_drop",{"_index":627,"title":{},"description":{"25":{}}}],["view_full_metadata",{"_index":632,"title":{},"description":{"25":{}}}],["view_list",{"_index":628,"title":{},"description":{"25":{}}}],["view_read_properti",{"_index":629,"title":{},"description":{"25":{}}}],["view_write_properti",{"_index":631,"title":{},"description":{"25":{}}}],["views](#view",{"_index":551,"title":{},"description":{"13":{}}}],["views](./entities.md#view",{"_index":177,"title":{},"description":{"4":{}}}],["views](https://iceberg.apache.org/view-spec",{"_index":560,"title":{},"description":{"15":{}}}],["want",{"_index":89,"title":{},"description":{"1":{}}}],["warehous",{"_index":790,"title":{},"description":{"66":{}}}],["warn",{"_index":666,"title":{},"description":{"27":{},"29":{}}}],["warranti",{"_index":361,"title":{},"description":{"6":{},"11":{},"20":{},"27":{}}}],["we'll",{"_index":140,"title":{},"description":{"3":{}}}],["well",{"_index":778,"title":{},"description":{"64":{}}}],["we’v",{"_index":256,"title":{},"description":{"4":{},"5":{}}}],["within",{"_index":270,"title":{},"description":{"4":{},"5":{},"7":{},"12":{},"13":{},"16":{},"17":{},"82":{},"92":{}}}],["without",{"_index":360,"title":{},"description":{"6":{},"9":{},"11":{},"20":{},"27":{},"37":{}}}],["won't",{"_index":597,"title":{},"description":{"23":{}}}],["won’t",{"_index":122,"title":{},"description":{"2":{}}}],["work",{"_index":344,"title":{},"description":{"6":{},"7":{},"11":{},"20":{},"26":{},"27":{}}}],["workflow",{"_index":503,"title":{"8":{}},"description":{"8":{}}}],["write",{"_index":202,"title":{},"description":{"4":{},"6":{},"7":{},"11":{},"20":{},"23":{},"25":{},"27":{}}}],["written",{"_index":417,"title":{},"description":{"7":{}}}],["xxxx",{"_index":247,"title":{},"description":{"4":{},"5":{}}}],["you'll",{"_index":39,"title":{},"description":{"1":{}}}],["you'v",{"_index":102,"title":{},"description":{"2":{}}}],["yourself",{"_index":62,"title":{},"description":{"1":{}}}],["you’ll",{"_index":213,"title":{},"description":{"4":{}}}],["you’r",{"_index":208,"title":{},"description":{"4":{}}}],["yyyi",{"_index":249,"title":{},"description":{"4":{},"5":{}}}],["zone",{"_index":650,"title":{},"description":{"26":{}}}]],"pipeline":[]}},"options":{"theme":{"typography":{"fontFamily":"Roboto, sans-serif"},"logo":{"gutter":"15px"}}}};
 
       var container = document.getElementById('redoc');
       Redoc.hydrate(__redoc_state, container);
diff --git a/docs/quickstart.md b/docs/quickstart.md
index 6fb6dd6ae..28397418a 100644
--- a/docs/quickstart.md
+++ b/docs/quickstart.md
@@ -262,7 +262,7 @@ bin/spark-shell \
 --packages org.apache.iceberg:iceberg-spark-runtime-3.5_2.12:1.5.2,org.apache.hadoop:hadoop-aws:3.4.0 \
 --conf spark.sql.extensions=org.apache.iceberg.spark.extensions.IcebergSparkSessionExtensions \
 --conf spark.sql.catalog.quickstart_catalog.warehouse=quickstart_catalog \
---conf spark.sql.catalog.quickstart_catalog.header.X-Iceberg-Access-Delegation=true \
+--conf spark.sql.catalog.quickstart_catalog.header.X-Iceberg-Access-Delegation=vended-credentials \
 --conf spark.sql.catalog.quickstart_catalog=org.apache.iceberg.spark.SparkCatalog \
 --conf spark.sql.catalog.quickstart_catalog.catalog-impl=org.apache.iceberg.rest.RESTCatalog \
 --conf spark.sql.catalog.quickstart_catalog.uri=http://localhost:8181/api/catalog \
diff --git a/notebooks/SparkPolaris.ipynb b/notebooks/SparkPolaris.ipynb
index b4fe58edf..f55db1dff 100644
--- a/notebooks/SparkPolaris.ipynb
+++ b/notebooks/SparkPolaris.ipynb
@@ -242,7 +242,7 @@
     "* Catalog URI points to our Polaris installation\n",
     "* Credential set using the client_id and client_secret generated for the principal\n",
     "* Scope set to `PRINCIPAL_ROLE:ALL`\n",
-    "* `X-Iceberg-Access-Delegation` is set to true"
+    "* `X-Iceberg-Access-Delegation` is set to vended-credentials"
    ]
   },
   {
@@ -278,7 +278,7 @@
     "  .config(\"spark.sql.catalog.polaris.scope\", 'PRINCIPAL_ROLE:ALL')\n",
     "\n",
     "  # Enable access credential delegation\n",
-    "  .config(\"spark.sql.catalog.polaris.header.X-Iceberg-Access-Delegation\", 'true')\n",
+    "  .config(\"spark.sql.catalog.polaris.header.X-Iceberg-Access-Delegation\", 'vended-credentials')\n",
     "\n",
     "  .config(\"spark.sql.catalog.polaris.io-impl\", \"org.apache.iceberg.io.ResolvingFileIO\")\n",
     "  .config(\"spark.sql.catalog.polaris.s3.region\", \"us-west-2\")\n",
diff --git a/polaris-service/src/main/java/org/apache/polaris/service/catalog/AccessDelegationMode.java b/polaris-service/src/main/java/org/apache/polaris/service/catalog/AccessDelegationMode.java
new file mode 100644
index 000000000..46c67622b
--- /dev/null
+++ b/polaris-service/src/main/java/org/apache/polaris/service/catalog/AccessDelegationMode.java
@@ -0,0 +1,74 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.apache.polaris.service.catalog;
+
+import com.google.common.base.Functions;
+import java.util.Arrays;
+import java.util.EnumSet;
+import java.util.Locale;
+import java.util.Map;
+import java.util.stream.Collectors;
+
+/**
+ * Represents access mechanisms defined in the Iceberg REST API specification (values for the {@code
+ * X-Iceberg-Access-Delegation} header).
+ */
+public enum AccessDelegationMode {
+  UNKNOWN("unknown"),
+  VENDED_CREDENTIALS("vended-credentials"),
+  REMOTE_SIGNING("remote-signing"),
+  ;
+
+  AccessDelegationMode(String protocolValue) {
+    this.protocolValue = protocolValue;
+  }
+
+  private final String protocolValue;
+
+  public String protocolValue() {
+    return protocolValue;
+  }
+
+  public static EnumSet<AccessDelegationMode> fromProtocolValuesList(String protocolValues) {
+    if (protocolValues == null || protocolValues.isEmpty()) {
+      return EnumSet.noneOf(AccessDelegationMode.class);
+    }
+
+    // Backward-compatibility case for old clients that still use the unofficial value of `true` to
+    // request credential vending. Note that if the client requests `true` among other values it
+    // will be parsed as `UNKNOWN` (by the code below this `if`) since the client submitting
+    // multiple access modes is expected to be aware of the Iceberg REST API spec.
+    if (protocolValues.trim().toLowerCase(Locale.ROOT).equals("true")) {
+      return EnumSet.of(VENDED_CREDENTIALS);
+    }
+
+    EnumSet<AccessDelegationMode> set = EnumSet.noneOf(AccessDelegationMode.class);
+    Arrays.stream(protocolValues.split(",")) // per Iceberg REST Catalog spec
+        .map(String::trim)
+        .map(n -> Mapper.byProtocolValue.getOrDefault(n, UNKNOWN))
+        .forEach(set::add);
+    return set;
+  }
+
+  private static class Mapper {
+    private static final Map<String, AccessDelegationMode> byProtocolValue =
+        Arrays.stream(AccessDelegationMode.values())
+            .collect(Collectors.toMap(AccessDelegationMode::protocolValue, Functions.identity()));
+  }
+}
diff --git a/polaris-service/src/main/java/org/apache/polaris/service/catalog/IcebergCatalogAdapter.java b/polaris-service/src/main/java/org/apache/polaris/service/catalog/IcebergCatalogAdapter.java
index 5d15fc538..53cc053b8 100644
--- a/polaris-service/src/main/java/org/apache/polaris/service/catalog/IcebergCatalogAdapter.java
+++ b/polaris-service/src/main/java/org/apache/polaris/service/catalog/IcebergCatalogAdapter.java
@@ -18,13 +18,15 @@
  */
 package org.apache.polaris.service.catalog;
 
+import static org.apache.polaris.service.catalog.AccessDelegationMode.VENDED_CREDENTIALS;
+
 import com.google.common.base.Preconditions;
-import com.google.common.base.Strings;
 import com.google.common.collect.ImmutableMap;
 import jakarta.ws.rs.core.Response;
 import jakarta.ws.rs.core.SecurityContext;
 import java.net.URLEncoder;
 import java.nio.charset.Charset;
+import java.util.EnumSet;
 import java.util.List;
 import java.util.Map;
 import java.util.Optional;
@@ -171,16 +173,28 @@ public Response updateProperties(
         .build();
   }
 
+  private EnumSet<AccessDelegationMode> parseAccessDelegationModes(String accessDelegationMode) {
+    EnumSet<AccessDelegationMode> delegationModes =
+        AccessDelegationMode.fromProtocolValuesList(accessDelegationMode);
+    Preconditions.checkArgument(
+        delegationModes.isEmpty() || delegationModes.contains(VENDED_CREDENTIALS),
+        "Unsupported access delegation mode: %s",
+        accessDelegationMode);
+    return delegationModes;
+  }
+
   @Override
   public Response createTable(
       String prefix,
       String namespace,
       CreateTableRequest createTableRequest,
-      String xIcebergAccessDelegation,
+      String accessDelegationMode,
       SecurityContext securityContext) {
+    EnumSet<AccessDelegationMode> delegationModes =
+        parseAccessDelegationModes(accessDelegationMode);
     Namespace ns = decodeNamespace(namespace);
     if (createTableRequest.stageCreate()) {
-      if (Strings.isNullOrEmpty(xIcebergAccessDelegation)) {
+      if (delegationModes.isEmpty()) {
         return Response.ok(
                 newHandlerWrapper(securityContext, prefix)
                     .createTableStaged(ns, createTableRequest))
@@ -188,11 +202,10 @@ public Response createTable(
       } else {
         return Response.ok(
                 newHandlerWrapper(securityContext, prefix)
-                    .createTableStagedWithWriteDelegation(
-                        ns, createTableRequest, xIcebergAccessDelegation))
+                    .createTableStagedWithWriteDelegation(ns, createTableRequest))
             .build();
       }
-    } else if (Strings.isNullOrEmpty(xIcebergAccessDelegation)) {
+    } else if (delegationModes.isEmpty()) {
       return Response.ok(
               newHandlerWrapper(securityContext, prefix).createTableDirect(ns, createTableRequest))
           .build();
@@ -220,20 +233,21 @@ public Response loadTable(
       String prefix,
       String namespace,
       String table,
-      String xIcebergAccessDelegation,
+      String accessDelegationMode,
       String snapshots,
       SecurityContext securityContext) {
+    EnumSet<AccessDelegationMode> delegationModes =
+        parseAccessDelegationModes(accessDelegationMode);
     Namespace ns = decodeNamespace(namespace);
     TableIdentifier tableIdentifier = TableIdentifier.of(ns, RESTUtil.decodeString(table));
-    if (Strings.isNullOrEmpty(xIcebergAccessDelegation)) {
+    if (delegationModes.isEmpty()) {
       return Response.ok(
               newHandlerWrapper(securityContext, prefix).loadTable(tableIdentifier, snapshots))
           .build();
     } else {
       return Response.ok(
               newHandlerWrapper(securityContext, prefix)
-                  .loadTableWithAccessDelegation(
-                      tableIdentifier, xIcebergAccessDelegation, snapshots))
+                  .loadTableWithAccessDelegation(tableIdentifier, snapshots))
           .build();
     }
   }
diff --git a/polaris-service/src/main/java/org/apache/polaris/service/catalog/PolarisCatalogHandlerWrapper.java b/polaris-service/src/main/java/org/apache/polaris/service/catalog/PolarisCatalogHandlerWrapper.java
index dfa552f52..78e3935d8 100644
--- a/polaris-service/src/main/java/org/apache/polaris/service/catalog/PolarisCatalogHandlerWrapper.java
+++ b/polaris-service/src/main/java/org/apache/polaris/service/catalog/PolarisCatalogHandlerWrapper.java
@@ -679,7 +679,7 @@ public LoadTableResponse createTableStaged(Namespace namespace, CreateTableReque
   }
 
   public LoadTableResponse createTableStagedWithWriteDelegation(
-      Namespace namespace, CreateTableRequest request, String xIcebergAccessDelegation) {
+      Namespace namespace, CreateTableRequest request) {
     PolarisAuthorizableOperation op =
         PolarisAuthorizableOperation.CREATE_TABLE_STAGED_WITH_WRITE_DELEGATION;
     authorizeCreateTableLikeUnderNamespaceOperationOrThrow(
@@ -770,7 +770,7 @@ public LoadTableResponse loadTable(TableIdentifier tableIdentifier, String snaps
   }
 
   public LoadTableResponse loadTableWithAccessDelegation(
-      TableIdentifier tableIdentifier, String xIcebergAccessDelegation, String snapshots) {
+      TableIdentifier tableIdentifier, String snapshots) {
     // Here we have a single method that falls through multiple candidate
     // PolarisAuthorizableOperations because instead of identifying the desired operation up-front
     // and
diff --git a/polaris-service/src/test/java/org/apache/polaris/service/catalog/AccessDelegationModeTest.java b/polaris-service/src/test/java/org/apache/polaris/service/catalog/AccessDelegationModeTest.java
new file mode 100644
index 000000000..367840116
--- /dev/null
+++ b/polaris-service/src/test/java/org/apache/polaris/service/catalog/AccessDelegationModeTest.java
@@ -0,0 +1,66 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+package org.apache.polaris.service.catalog;
+
+import static org.apache.polaris.service.catalog.AccessDelegationMode.*;
+import static org.apache.polaris.service.catalog.AccessDelegationMode.REMOTE_SIGNING;
+import static org.apache.polaris.service.catalog.AccessDelegationMode.VENDED_CREDENTIALS;
+import static org.apache.polaris.service.catalog.AccessDelegationMode.fromProtocolValuesList;
+import static org.assertj.core.api.Assertions.assertThat;
+
+import java.util.EnumSet;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.params.ParameterizedTest;
+import org.junit.jupiter.params.provider.EnumSource;
+
+class AccessDelegationModeTest {
+
+  @ParameterizedTest
+  @EnumSource(AccessDelegationMode.class)
+  void testSingle(AccessDelegationMode mode) {
+    assertThat(fromProtocolValuesList(mode.protocolValue())).isEqualTo(EnumSet.of(mode));
+  }
+
+  @Test
+  void testSeveral() {
+    assertThat(fromProtocolValuesList("vended-credentials, remote-signing"))
+        .isEqualTo(EnumSet.of(VENDED_CREDENTIALS, REMOTE_SIGNING));
+  }
+
+  @Test
+  void testEmpty() {
+    assertThat(fromProtocolValuesList(null)).isEqualTo(EnumSet.noneOf(AccessDelegationMode.class));
+    assertThat(fromProtocolValuesList("")).isEqualTo(EnumSet.noneOf(AccessDelegationMode.class));
+  }
+
+  @Test
+  void testUnknown() {
+    assertThat(fromProtocolValuesList("abc")).isEqualTo(EnumSet.of(UNKNOWN));
+    assertThat(fromProtocolValuesList("abc,def")).isEqualTo(EnumSet.of(UNKNOWN));
+    assertThat(fromProtocolValuesList("abc,remote-signing"))
+        .isEqualTo(EnumSet.of(REMOTE_SIGNING, UNKNOWN));
+  }
+
+  @Test
+  void testLegacy() {
+    assertThat(fromProtocolValuesList("true")).isEqualTo(EnumSet.of(VENDED_CREDENTIALS));
+    assertThat(fromProtocolValuesList("true, vended-credentials"))
+        .isEqualTo(EnumSet.of(UNKNOWN, VENDED_CREDENTIALS));
+  }
+}
diff --git a/polaris-service/src/test/java/org/apache/polaris/service/catalog/PolarisCatalogHandlerWrapperAuthzTest.java b/polaris-service/src/test/java/org/apache/polaris/service/catalog/PolarisCatalogHandlerWrapperAuthzTest.java
index 8566e6ac1..537f5856c 100644
--- a/polaris-service/src/test/java/org/apache/polaris/service/catalog/PolarisCatalogHandlerWrapperAuthzTest.java
+++ b/polaris-service/src/test/java/org/apache/polaris/service/catalog/PolarisCatalogHandlerWrapperAuthzTest.java
@@ -706,8 +706,7 @@ public void testCreateTableStagedWithWriteDelegationAllSufficientPrivileges() {
             Set.of(PolarisPrivilege.CATALOG_MANAGE_CONTENT)),
         () -> {
           newWrapper(Set.of(PRINCIPAL_ROLE1))
-              .createTableStagedWithWriteDelegation(
-                  NS2, createStagedWithWriteDelegationRequest, "vended-credentials");
+              .createTableStagedWithWriteDelegation(NS2, createStagedWithWriteDelegationRequest);
         },
         // createTableStagedWithWriteDelegation doesn't actually commit any metadata
         null,
@@ -736,8 +735,7 @@ public void testCreateTableStagedWithWriteDelegationInsufficientPermissions() {
             PolarisPrivilege.TABLE_LIST),
         () -> {
           newWrapper(Set.of(PRINCIPAL_ROLE1))
-              .createTableStagedWithWriteDelegation(
-                  NS2, createStagedWithWriteDelegationRequest, "vended-credentials");
+              .createTableStagedWithWriteDelegation(NS2, createStagedWithWriteDelegationRequest);
         });
   }
 
@@ -855,7 +853,7 @@ public void testLoadTableWithReadAccessDelegationSufficientPrivileges() {
             PolarisPrivilege.TABLE_READ_DATA,
             PolarisPrivilege.TABLE_WRITE_DATA,
             PolarisPrivilege.CATALOG_MANAGE_CONTENT),
-        () -> newWrapper().loadTableWithAccessDelegation(TABLE_NS1A_2, "vended-credentials", "all"),
+        () -> newWrapper().loadTableWithAccessDelegation(TABLE_NS1A_2, "all"),
         null /* cleanupAction */);
   }
 
@@ -871,8 +869,7 @@ public void testLoadTableWithReadAccessDelegationInsufficientPermissions() {
             PolarisPrivilege.TABLE_CREATE,
             PolarisPrivilege.TABLE_LIST,
             PolarisPrivilege.TABLE_DROP),
-        () ->
-            newWrapper().loadTableWithAccessDelegation(TABLE_NS1A_2, "vended-credentials", "all"));
+        () -> newWrapper().loadTableWithAccessDelegation(TABLE_NS1A_2, "all"));
   }
 
   @Test
@@ -885,7 +882,7 @@ public void testLoadTableWithWriteAccessDelegationSufficientPrivileges() {
             PolarisPrivilege.TABLE_READ_DATA,
             PolarisPrivilege.TABLE_WRITE_DATA,
             PolarisPrivilege.CATALOG_MANAGE_CONTENT),
-        () -> newWrapper().loadTableWithAccessDelegation(TABLE_NS1A_2, "vended-credentials", "all"),
+        () -> newWrapper().loadTableWithAccessDelegation(TABLE_NS1A_2, "all"),
         null /* cleanupAction */);
   }
 
@@ -901,8 +898,7 @@ public void testLoadTableWithWriteAccessDelegationInsufficientPermissions() {
             PolarisPrivilege.TABLE_CREATE,
             PolarisPrivilege.TABLE_LIST,
             PolarisPrivilege.TABLE_DROP),
-        () ->
-            newWrapper().loadTableWithAccessDelegation(TABLE_NS1A_2, "vended-credentials", "all"));
+        () -> newWrapper().loadTableWithAccessDelegation(TABLE_NS1A_2, "all"));
   }
 
   @Test
diff --git a/regtests/setup.sh b/regtests/setup.sh
index 10fd8500f..2c15f931d 100755
--- a/regtests/setup.sh
+++ b/regtests/setup.sh
@@ -112,7 +112,7 @@ spark.driver.extraJavaOptions -Dderby.system.home=${DERBY_HOME}
 spark.sql.catalog.polaris=org.apache.iceberg.spark.SparkCatalog
 spark.sql.catalog.polaris.type=rest
 spark.sql.catalog.polaris.uri=http://${POLARIS_HOST:-localhost}:8181/api/catalog
-spark.sql.catalog.polaris.header.X-Iceberg-Access-Delegation=true
+spark.sql.catalog.polaris.header.X-Iceberg-Access-Delegation=vended-credentials
 spark.sql.catalog.polaris.client.region=us-west-2
 EOF
   echo 'Success!'
diff --git a/regtests/t_pyspark/src/iceberg_spark.py b/regtests/t_pyspark/src/iceberg_spark.py
index 48b56b155..a3707975c 100644
--- a/regtests/t_pyspark/src/iceberg_spark.py
+++ b/regtests/t_pyspark/src/iceberg_spark.py
@@ -102,7 +102,7 @@ def __enter__(self):
       .config(
         f"spark.sql.catalog.{catalog_name}", "org.apache.iceberg.spark.SparkCatalog"
       )
-      .config(f"spark.sql.catalog.{catalog_name}.header.X-Iceberg-Access-Delegation", "true")
+      .config(f"spark.sql.catalog.{catalog_name}.header.X-Iceberg-Access-Delegation", "vended-credentials")
       .config(f"spark.sql.catalog.{catalog_name}.type", "rest")
       .config(f"spark.sql.catalog.{catalog_name}.uri", self.polaris_url)
       .config(f"spark.sql.catalog.{catalog_name}.warehouse", self.catalog_name)
diff --git a/spec/index.yaml b/spec/index.yaml
index 0a230df52..3ceb88fd3 100644
--- a/spec/index.yaml
+++ b/spec/index.yaml
@@ -4,7 +4,7 @@ info:
   x-logo:
     url: ./img/logos/polaris-catalog-stacked-logo.svg
     altText: Apache Polaris Logo
-  description: "<!--\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://www.apache.org/licenses/LICENSE-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# Quick Start\n\nThis guide serves as a introduction to several key entities that can be managed with Apache Polaris (Incubating), describes how to build and deploy Polaris locally, and finally includes examples of how to use Polaris with Apache Spark&trade;.\n\n## Prerequisites\n\nThis guide covers building Polaris, deploying it locally or via [Docker](https://www.docker.com/), and interacting with it using the command-line interface and [Apache Spark](https://spark.apache.org/). Before proceeding with Polaris, be sure to satisfy the relevant prerequisites listed here.\n\n### Building and Deploying Polaris\n\nTo get the latest Polaris code, you'll need to clone the repository using [git](https://git-scm.com/). You can install git using [homebrew](https://brew.sh/):\n\n```shell\nbrew install git\n```\n\nThen, use git to clone the Polaris repo:\n\n```shell\ncd ~\ngit clone https://github.com/apache/polaris.git\n```\n\n#### With Docker\n\nIf you plan to deploy Polaris inside [Docker](https://www.docker.com/), you'll need to install docker itself. For example, this can be done using [homebrew](https://brew.sh/):\n\n```shell\nbrew install --cask docker\n```\n\nOnce installed, make sure Docker is running.\n\n#### From Source\n\nIf you plan to build Polaris from source yourself, you will need to satisfy a few prerequisites first.\n\nPolaris is built using [gradle](https://gradle.org/) and is compatible with Java 21. We recommend the use of [jenv](https://www.jenv.be/) to manage multiple Java versions. For example, to install Java 21 via [homebrew](https://brew.sh/) and configure it with jenv: \n\n```shell\ncd ~/polaris\nbrew install openjdk@21 jenv\njenv add $(brew --prefix openjdk@21)\njenv local 21\n```\n\n### Connecting to Polaris\n\nPolaris is compatible with any [Apache Iceberg](https://iceberg.apache.org/) client that supports the REST API. Depending on the client you plan to use, refer to the prerequisites below.\n\n#### With Spark\n\nIf you want to connect to Polaris with [Apache Spark](https://spark.apache.org/), you'll need to start by cloning Spark. As [above](#building-and-deploying-polaris), make sure [git](https://git-scm.com/) is installed first. You can install it with [homebrew](https://brew.sh/):\n\n```shell\nbrew install git\n```\n\nThen, clone Spark and check out a versioned branch. This guide uses [Spark 3.5](https://spark.apache.org/releases/spark-release-3-5-0.html).\n\n```shell\ncd ~\ngit clone https://github.com/apache/spark.git\ncd ~/spark\ngit checkout branch-3.5\n```\n\n## Deploying Polaris\n\nPolaris can be deployed via a lightweight docker image or as a standalone process. Before starting, be sure that you've satisfied the relevant [prerequisites](#building-and-deploying-polaris) detailed above.\n\n### Docker Image\n\nTo start using Polaris in Docker, launch Polaris while Docker is running:\n\n```shell\ncd ~/polaris\ndocker compose -f docker-compose.yml up --build\n```\n\nOnce the `polaris-polaris` container is up, you can continue to [Defining a Catalog](#defining-a-catalog).\n\n### Building Polaris\n\nRun Polaris locally with:\n\n```shell\ncd ~/polaris\n./gradlew runApp\n```\n\nYou should see output for some time as Polaris builds and starts up. Eventually, you won’t see any more logs and should see messages that resemble the following:\n\n```\nINFO  [...] [main] [] o.e.j.s.handler.ContextHandler: Started i.d.j.MutableServletContextHandler@...\nINFO  [...] [main] [] o.e.j.server.AbstractConnector: Started application@...\nINFO  [...] [main] [] o.e.j.server.AbstractConnector: Started admin@...\nINFO  [...] [main] [] o.eclipse.jetty.server.Server: Started Server@...\n```\n\nAt this point, Polaris is running.\n\n## Bootstrapping Polaris\n\nFor this tutorial, we'll launch an instance of Polaris that stores entities only in-memory. This means that any entities that you define will be destroyed when Polaris is shut down. It also means that Polaris will automatically bootstrap itself with root credentials. For more information on how to configure Polaris for production usage, see the [docs](./configuring-polaris-for-production.md).\n\nWhen Polaris is launched using in-memory mode the root principal credentials can be found in stdout on initial startup. For example:\n\n```\nrealm: default-realm root principal credentials: <client-id>:<client-secret>\n```\n\nBe sure to note of these credentials as we'll be using them below. You can also set these credentials as environment variables for use with the Polaris CLI:\n\n```shell\nexport CLIENT_ID=<client-id> \nexport CLIENT_SECRET=<client-secret>\n```\n\n## Defining a Catalog\n\nIn Polaris, the [catalog](./entities.md#catalog) is the top-level entity that objects like [tables](./entities.md#table) and [views](./entities.md#view) are organized under. With a Polaris service running, you can create a catalog like so:\n\n```shell\ncd ~/polaris\n\n./polaris \\\n  --client-id ${CLIENT_ID} \\\n  --client-secret ${CLIENT_SECRET} \\\n  catalogs \\\n  create \\\n  --storage-type s3 \\\n  --default-base-location ${DEFAULT_BASE_LOCATION} \\\n  --role-arn ${ROLE_ARN} \\\n  quickstart_catalog\n```\n\nThis will create a new catalog called **quickstart_catalog**.\n\nThe `DEFAULT_BASE_LOCATION` you provide will be the default location that objects in this catalog should be stored in, and the `ROLE_ARN` you provide should be a [Role ARN](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) with access to read and write data in that location. These credentials will be provided to engines reading data from the catalog once they have authenticated with Polaris using credentials that have access to those resources.\n\nIf you’re using a storage type other than S3, such as Azure, you’ll provide a different type of credential than a Role ARN. For more details on supported storage types, see the [docs](./entities.md#storage-type).\n\nAdditionally, if Polaris is running somewhere other than `localhost:8181`, you can specify the correct hostname and port by providing `--host` and `--port` flags. For the full set of options supported by the CLI, please refer to the [docs](./command-line-interface.md).\n\n\n### Creating a Principal and Assigning it Privileges\n\nWith a catalog created, we can create a [principal](./entities.md#principal) that has access to manage that catalog. For details on how to configure the Polaris CLI, see [the section above](#defining-a-catalog) or refer to the [docs](./command-line-interface.md).\n\n```shell\n./polaris \\\n  --client-id ${CLIENT_ID} \\\n  --client-secret ${CLIENT_SECRET} \\\n  principals \\\n  create \\\n  quickstart_user\n\n./polaris \\\n  --client-id ${CLIENT_ID} \\\n  --client-secret ${CLIENT_SECRET} \\\n  principal-roles \\\n  create \\\n  quickstart_user_role\n\n./polaris \\\n  --client-id ${CLIENT_ID} \\\n  --client-secret ${CLIENT_SECRET} \\\n  catalog-roles \\\n  create \\\n  --catalog quickstart_catalog \\\n  quickstart_catalog_role\n```\n\nBe sure to provide the necessary credentials, hostname, and port as before.\n\nWhen the `principals create` command completes successfully, it will return the credentials for this new principal. Be sure to note these down for later. For example:\n\n```\n./polaris ... principals create example\n{\"clientId\": \"XXXX\", \"clientSecret\": \"YYYY\"}\n```\n\nNow, we grant the principal the [principal role](./entities.md#principal-role) we created, and grant the [catalog role](./entities.md#catalog-role) the principal role we created. For more information on these entities, please refer to the linked documentation.\n\n```shell\n./polaris \\\n  --client-id ${CLIENT_ID} \\\n  --client-secret ${CLIENT_SECRET} \\\n  principal-roles \\\n  grant \\\n  --principal quickstart_user \\\n  quickstart_user_role\n\n./polaris \\\n  --client-id ${CLIENT_ID} \\\n  --client-secret ${CLIENT_SECRET} \\\n  catalog-roles \\\n  grant \\\n  --catalog quickstart_catalog \\\n  --principal-role quickstart_user_role \\\n  quickstart_catalog_role\n```\n\nNow, we’ve linked our principal to the catalog via roles like so:\n\n![Principal to Catalog](./img/quickstart/privilege-illustration-1.png \"Principal to Catalog\")\n\nIn order to give this principal the ability to interact with the catalog, we must assign some [privileges](./entities.md#privilege). For the time being, we will give this principal the ability to fully manage content in our new catalog. We can do this with the CLI like so:\n\n```shell\n./polaris \\\n  --client-id ${CLIENT_ID} \\\n  --client-secret ${CLIENT_SECRET} \\\n  privileges \\\n  catalog \\\n  grant \\\n  --catalog quickstart_catalog \\\n  --catalog-role quickstart_catalog_role \\\n  CATALOG_MANAGE_CONTENT\n```\n\nThis grants the [catalog privileges](./entities.md#privilege) `CATALOG_MANAGE_CONTENT` to our catalog role, linking everything together like so:\n\n![Principal to Catalog with Catalog Role](./img/quickstart/privilege-illustration-2.png \"Principal to Catalog with Catalog Role\")\n\n`CATALOG_MANAGE_CONTENT` has create/list/read/write privileges on all entities within the catalog. The same privilege could be granted to a namespace, in which case the principal could create/list/read/write any entity under that namespace.\n\n## Using Iceberg & Polaris\n\nAt this point, we’ve created a principal and granted it the ability to manage a catalog. We can now use an external engine to assume that principal, access our catalog, and store data in that catalog using [Apache Iceberg](https://iceberg.apache.org/).\n\n### Connecting with Spark\n\nTo use a Polaris-managed catalog in [Apache Spark](https://spark.apache.org/), we can configure Spark to use the Iceberg catalog REST API.\n\nThis guide uses [Apache Spark 3.5](https://spark.apache.org/releases/spark-release-3-5-0.html), but be sure to find [the appropriate iceberg-spark package for your Spark version](https://mvnrepository.com/artifact/org.apache.iceberg/iceberg-spark). From a local Spark clone on the `branch-3.5` branch we can run the following:\n\n_Note: the credentials provided here are those for our principal, not the root credentials._\n\n```shell\nbin/spark-shell \\\n--packages org.apache.iceberg:iceberg-spark-runtime-3.5_2.12:1.5.2,org.apache.hadoop:hadoop-aws:3.4.0 \\\n--conf spark.sql.extensions=org.apache.iceberg.spark.extensions.IcebergSparkSessionExtensions \\\n--conf spark.sql.catalog.quickstart_catalog.warehouse=quickstart_catalog \\\n--conf spark.sql.catalog.quickstart_catalog.header.X-Iceberg-Access-Delegation=true \\\n--conf spark.sql.catalog.quickstart_catalog=org.apache.iceberg.spark.SparkCatalog \\\n--conf spark.sql.catalog.quickstart_catalog.catalog-impl=org.apache.iceberg.rest.RESTCatalog \\\n--conf spark.sql.catalog.quickstart_catalog.uri=http://localhost:8181/api/catalog \\\n--conf spark.sql.catalog.quickstart_catalog.credential='XXXX:YYYY' \\\n--conf spark.sql.catalog.quickstart_catalog.scope='PRINCIPAL_ROLE:ALL' \\\n--conf spark.sql.catalog.quickstart_catalog.token-refresh-enabled=true\n```\n\n\nReplace `XXXX` and `YYYY` with the client ID and client secret generated when you created the `quickstart_user` principal.\n\nSimilar to the CLI commands above, this configures Spark to use the Polaris running at `localhost:8181`. If your Polaris server is running elsewhere, but sure to update the configuration appropriately.\n\nFinally, note that we include the `hadoop-aws` package here. If your table is using a different filesystem, be sure to include the appropriate dependency.\n\nOnce the Spark session starts, we can create a namespace and table within the catalog:\n\n```\nspark.sql(\"USE quickstart_catalog\")\nspark.sql(\"CREATE NAMESPACE IF NOT EXISTS quickstart_namespace\")\nspark.sql(\"CREATE NAMESPACE IF NOT EXISTS quickstart_namespace.schema\")\nspark.sql(\"USE NAMESPACE quickstart_namespace.schema\")\nspark.sql(\"\"\"\n\tCREATE TABLE IF NOT EXISTS quickstart_table (\n\t\tid BIGINT, data STRING\n\t) \nUSING ICEBERG\n\"\"\")\n```\n\nWe can now use this table like any other:\n\n```\nspark.sql(\"INSERT INTO quickstart_table VALUES (1, 'some data')\")\nspark.sql(\"SELECT * FROM quickstart_table\").show(false)\n. . .\n+---+---------+\n|id |data     |\n+---+---------+\n|1  |some data|\n+---+---------+\n```\n\nIf at any time access is revoked...\n\n```shell\n./polaris \\\n  --client-id ${CLIENT_ID} \\\n  --client-secret ${CLIENT_SECRET} \\\n  privileges \\\n  catalog \\\n  revoke \\\n  --catalog quickstart_catalog \\\n  --catalog-role quickstart_catalog_role \\\n  CATALOG_MANAGE_CONTENT\n```\n\nSpark will lose access to the table:\n\n```\nspark.sql(\"SELECT * FROM quickstart_table\").show(false)\n\norg.apache.iceberg.exceptions.ForbiddenException: Forbidden: Principal 'quickstart_user' with activated PrincipalRoles '[]' and activated ids '[6, 7]' is not authorized for op LOAD_TABLE_WITH_READ_DELEGATION\n```\n"
+  description: "<!--\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://www.apache.org/licenses/LICENSE-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# Quick Start\n\nThis guide serves as a introduction to several key entities that can be managed with Apache Polaris (Incubating), describes how to build and deploy Polaris locally, and finally includes examples of how to use Polaris with Apache Spark&trade;.\n\n## Prerequisites\n\nThis guide covers building Polaris, deploying it locally or via [Docker](https://www.docker.com/), and interacting with it using the command-line interface and [Apache Spark](https://spark.apache.org/). Before proceeding with Polaris, be sure to satisfy the relevant prerequisites listed here.\n\n### Building and Deploying Polaris\n\nTo get the latest Polaris code, you'll need to clone the repository using [git](https://git-scm.com/). You can install git using [homebrew](https://brew.sh/):\n\n```shell\nbrew install git\n```\n\nThen, use git to clone the Polaris repo:\n\n```shell\ncd ~\ngit clone https://github.com/apache/polaris.git\n```\n\n#### With Docker\n\nIf you plan to deploy Polaris inside [Docker](https://www.docker.com/), you'll need to install docker itself. For example, this can be done using [homebrew](https://brew.sh/):\n\n```shell\nbrew install --cask docker\n```\n\nOnce installed, make sure Docker is running.\n\n#### From Source\n\nIf you plan to build Polaris from source yourself, you will need to satisfy a few prerequisites first.\n\nPolaris is built using [gradle](https://gradle.org/) and is compatible with Java 21. We recommend the use of [jenv](https://www.jenv.be/) to manage multiple Java versions. For example, to install Java 21 via [homebrew](https://brew.sh/) and configure it with jenv: \n\n```shell\ncd ~/polaris\nbrew install openjdk@21 jenv\njenv add $(brew --prefix openjdk@21)\njenv local 21\n```\n\n### Connecting to Polaris\n\nPolaris is compatible with any [Apache Iceberg](https://iceberg.apache.org/) client that supports the REST API. Depending on the client you plan to use, refer to the prerequisites below.\n\n#### With Spark\n\nIf you want to connect to Polaris with [Apache Spark](https://spark.apache.org/), you'll need to start by cloning Spark. As [above](#building-and-deploying-polaris), make sure [git](https://git-scm.com/) is installed first. You can install it with [homebrew](https://brew.sh/):\n\n```shell\nbrew install git\n```\n\nThen, clone Spark and check out a versioned branch. This guide uses [Spark 3.5](https://spark.apache.org/releases/spark-release-3-5-0.html).\n\n```shell\ncd ~\ngit clone https://github.com/apache/spark.git\ncd ~/spark\ngit checkout branch-3.5\n```\n\n## Deploying Polaris\n\nPolaris can be deployed via a lightweight docker image or as a standalone process. Before starting, be sure that you've satisfied the relevant [prerequisites](#building-and-deploying-polaris) detailed above.\n\n### Docker Image\n\nTo start using Polaris in Docker, launch Polaris while Docker is running:\n\n```shell\ncd ~/polaris\ndocker compose -f docker-compose.yml up --build\n```\n\nOnce the `polaris-polaris` container is up, you can continue to [Defining a Catalog](#defining-a-catalog).\n\n### Building Polaris\n\nRun Polaris locally with:\n\n```shell\ncd ~/polaris\n./gradlew runApp\n```\n\nYou should see output for some time as Polaris builds and starts up. Eventually, you won’t see any more logs and should see messages that resemble the following:\n\n```\nINFO  [...] [main] [] o.e.j.s.handler.ContextHandler: Started i.d.j.MutableServletContextHandler@...\nINFO  [...] [main] [] o.e.j.server.AbstractConnector: Started application@...\nINFO  [...] [main] [] o.e.j.server.AbstractConnector: Started admin@...\nINFO  [...] [main] [] o.eclipse.jetty.server.Server: Started Server@...\n```\n\nAt this point, Polaris is running.\n\n## Bootstrapping Polaris\n\nFor this tutorial, we'll launch an instance of Polaris that stores entities only in-memory. This means that any entities that you define will be destroyed when Polaris is shut down. It also means that Polaris will automatically bootstrap itself with root credentials. For more information on how to configure Polaris for production usage, see the [docs](./configuring-polaris-for-production.md).\n\nWhen Polaris is launched using in-memory mode the root principal credentials can be found in stdout on initial startup. For example:\n\n```\nrealm: default-realm root principal credentials: <client-id>:<client-secret>\n```\n\nBe sure to note of these credentials as we'll be using them below. You can also set these credentials as environment variables for use with the Polaris CLI:\n\n```shell\nexport CLIENT_ID=<client-id> \nexport CLIENT_SECRET=<client-secret>\n```\n\n## Defining a Catalog\n\nIn Polaris, the [catalog](./entities.md#catalog) is the top-level entity that objects like [tables](./entities.md#table) and [views](./entities.md#view) are organized under. With a Polaris service running, you can create a catalog like so:\n\n```shell\ncd ~/polaris\n\n./polaris \\\n  --client-id ${CLIENT_ID} \\\n  --client-secret ${CLIENT_SECRET} \\\n  catalogs \\\n  create \\\n  --storage-type s3 \\\n  --default-base-location ${DEFAULT_BASE_LOCATION} \\\n  --role-arn ${ROLE_ARN} \\\n  quickstart_catalog\n```\n\nThis will create a new catalog called **quickstart_catalog**.\n\nThe `DEFAULT_BASE_LOCATION` you provide will be the default location that objects in this catalog should be stored in, and the `ROLE_ARN` you provide should be a [Role ARN](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) with access to read and write data in that location. These credentials will be provided to engines reading data from the catalog once they have authenticated with Polaris using credentials that have access to those resources.\n\nIf you’re using a storage type other than S3, such as Azure, you’ll provide a different type of credential than a Role ARN. For more details on supported storage types, see the [docs](./entities.md#storage-type).\n\nAdditionally, if Polaris is running somewhere other than `localhost:8181`, you can specify the correct hostname and port by providing `--host` and `--port` flags. For the full set of options supported by the CLI, please refer to the [docs](./command-line-interface.md).\n\n\n### Creating a Principal and Assigning it Privileges\n\nWith a catalog created, we can create a [principal](./entities.md#principal) that has access to manage that catalog. For details on how to configure the Polaris CLI, see [the section above](#defining-a-catalog) or refer to the [docs](./command-line-interface.md).\n\n```shell\n./polaris \\\n  --client-id ${CLIENT_ID} \\\n  --client-secret ${CLIENT_SECRET} \\\n  principals \\\n  create \\\n  quickstart_user\n\n./polaris \\\n  --client-id ${CLIENT_ID} \\\n  --client-secret ${CLIENT_SECRET} \\\n  principal-roles \\\n  create \\\n  quickstart_user_role\n\n./polaris \\\n  --client-id ${CLIENT_ID} \\\n  --client-secret ${CLIENT_SECRET} \\\n  catalog-roles \\\n  create \\\n  --catalog quickstart_catalog \\\n  quickstart_catalog_role\n```\n\nBe sure to provide the necessary credentials, hostname, and port as before.\n\nWhen the `principals create` command completes successfully, it will return the credentials for this new principal. Be sure to note these down for later. For example:\n\n```\n./polaris ... principals create example\n{\"clientId\": \"XXXX\", \"clientSecret\": \"YYYY\"}\n```\n\nNow, we grant the principal the [principal role](./entities.md#principal-role) we created, and grant the [catalog role](./entities.md#catalog-role) the principal role we created. For more information on these entities, please refer to the linked documentation.\n\n```shell\n./polaris \\\n  --client-id ${CLIENT_ID} \\\n  --client-secret ${CLIENT_SECRET} \\\n  principal-roles \\\n  grant \\\n  --principal quickstart_user \\\n  quickstart_user_role\n\n./polaris \\\n  --client-id ${CLIENT_ID} \\\n  --client-secret ${CLIENT_SECRET} \\\n  catalog-roles \\\n  grant \\\n  --catalog quickstart_catalog \\\n  --principal-role quickstart_user_role \\\n  quickstart_catalog_role\n```\n\nNow, we’ve linked our principal to the catalog via roles like so:\n\n![Principal to Catalog](./img/quickstart/privilege-illustration-1.png \"Principal to Catalog\")\n\nIn order to give this principal the ability to interact with the catalog, we must assign some [privileges](./entities.md#privilege). For the time being, we will give this principal the ability to fully manage content in our new catalog. We can do this with the CLI like so:\n\n```shell\n./polaris \\\n  --client-id ${CLIENT_ID} \\\n  --client-secret ${CLIENT_SECRET} \\\n  privileges \\\n  catalog \\\n  grant \\\n  --catalog quickstart_catalog \\\n  --catalog-role quickstart_catalog_role \\\n  CATALOG_MANAGE_CONTENT\n```\n\nThis grants the [catalog privileges](./entities.md#privilege) `CATALOG_MANAGE_CONTENT` to our catalog role, linking everything together like so:\n\n![Principal to Catalog with Catalog Role](./img/quickstart/privilege-illustration-2.png \"Principal to Catalog with Catalog Role\")\n\n`CATALOG_MANAGE_CONTENT` has create/list/read/write privileges on all entities within the catalog. The same privilege could be granted to a namespace, in which case the principal could create/list/read/write any entity under that namespace.\n\n## Using Iceberg & Polaris\n\nAt this point, we’ve created a principal and granted it the ability to manage a catalog. We can now use an external engine to assume that principal, access our catalog, and store data in that catalog using [Apache Iceberg](https://iceberg.apache.org/).\n\n### Connecting with Spark\n\nTo use a Polaris-managed catalog in [Apache Spark](https://spark.apache.org/), we can configure Spark to use the Iceberg catalog REST API.\n\nThis guide uses [Apache Spark 3.5](https://spark.apache.org/releases/spark-release-3-5-0.html), but be sure to find [the appropriate iceberg-spark package for your Spark version](https://mvnrepository.com/artifact/org.apache.iceberg/iceberg-spark). From a local Spark clone on the `branch-3.5` branch we can run the following:\n\n_Note: the credentials provided here are those for our principal, not the root credentials._\n\n```shell\nbin/spark-shell \\\n--packages org.apache.iceberg:iceberg-spark-runtime-3.5_2.12:1.5.2,org.apache.hadoop:hadoop-aws:3.4.0 \\\n--conf spark.sql.extensions=org.apache.iceberg.spark.extensions.IcebergSparkSessionExtensions \\\n--conf spark.sql.catalog.quickstart_catalog.warehouse=quickstart_catalog \\\n--conf spark.sql.catalog.quickstart_catalog.header.X-Iceberg-Access-Delegation=vended-credentials \\\n--conf spark.sql.catalog.quickstart_catalog=org.apache.iceberg.spark.SparkCatalog \\\n--conf spark.sql.catalog.quickstart_catalog.catalog-impl=org.apache.iceberg.rest.RESTCatalog \\\n--conf spark.sql.catalog.quickstart_catalog.uri=http://localhost:8181/api/catalog \\\n--conf spark.sql.catalog.quickstart_catalog.credential='XXXX:YYYY' \\\n--conf spark.sql.catalog.quickstart_catalog.scope='PRINCIPAL_ROLE:ALL' \\\n--conf spark.sql.catalog.quickstart_catalog.token-refresh-enabled=true\n```\n\n\nReplace `XXXX` and `YYYY` with the client ID and client secret generated when you created the `quickstart_user` principal.\n\nSimilar to the CLI commands above, this configures Spark to use the Polaris running at `localhost:8181`. If your Polaris server is running elsewhere, but sure to update the configuration appropriately.\n\nFinally, note that we include the `hadoop-aws` package here. If your table is using a different filesystem, be sure to include the appropriate dependency.\n\nOnce the Spark session starts, we can create a namespace and table within the catalog:\n\n```\nspark.sql(\"USE quickstart_catalog\")\nspark.sql(\"CREATE NAMESPACE IF NOT EXISTS quickstart_namespace\")\nspark.sql(\"CREATE NAMESPACE IF NOT EXISTS quickstart_namespace.schema\")\nspark.sql(\"USE NAMESPACE quickstart_namespace.schema\")\nspark.sql(\"\"\"\n\tCREATE TABLE IF NOT EXISTS quickstart_table (\n\t\tid BIGINT, data STRING\n\t) \nUSING ICEBERG\n\"\"\")\n```\n\nWe can now use this table like any other:\n\n```\nspark.sql(\"INSERT INTO quickstart_table VALUES (1, 'some data')\")\nspark.sql(\"SELECT * FROM quickstart_table\").show(false)\n. . .\n+---+---------+\n|id |data     |\n+---+---------+\n|1  |some data|\n+---+---------+\n```\n\nIf at any time access is revoked...\n\n```shell\n./polaris \\\n  --client-id ${CLIENT_ID} \\\n  --client-secret ${CLIENT_SECRET} \\\n  privileges \\\n  catalog \\\n  revoke \\\n  --catalog quickstart_catalog \\\n  --catalog-role quickstart_catalog_role \\\n  CATALOG_MANAGE_CONTENT\n```\n\nSpark will lose access to the table:\n\n```\nspark.sql(\"SELECT * FROM quickstart_table\").show(false)\n\norg.apache.iceberg.exceptions.ForbiddenException: Forbidden: Principal 'quickstart_user' with activated PrincipalRoles '[]' and activated ids '[6, 7]' is not authorized for op LOAD_TABLE_WITH_READ_DELEGATION\n```\n"
   contact:
     email: dev [at] polaris.apache.org
     url: https://github.com/apache/polaris