You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@polaris.apache.org by "viv-tong (via GitHub)" <gi...@apache.org> on 2026/03/09 23:00:00 UTC
[PR] Update quickstart command [polaris]
viv-tong opened a new pull request, #3964:
URL: https://github.com/apache/polaris/pull/3964
Updating documentation. The command has been updated to from `quickstart_catalog` to `polaris`.
## Checklist
- [ ] ๐ก๏ธ Don't disclose security issues! (contact security@apache.org)
- [ ] ๐ Clearly explained why the changes are needed, or linked related issues: Fixes #
- [ ] ๐งช Added/updated tests with good coverage, or manually tested (and explained how)
- [ ] ๐ก Added comments for complex logic
- [ ] ๐งพ Updated `CHANGELOG.md` (if needed)
- [x] ๐ Updated documentation in `site/content/in-dev/unreleased` (if needed)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@polaris.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Update quickstart command [polaris]
Posted by "dimas-b (via GitHub)" <gi...@apache.org>.
dimas-b commented on PR #3964:
URL: https://github.com/apache/polaris/pull/3964#issuecomment-4031656114
Yes, we need to fix the URL to the docker-compose YAML file :+1:
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@polaris.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Update quickstart command [polaris]
Posted by "adnanhemani (via GitHub)" <gi...@apache.org>.
adnanhemani commented on code in PR #3964:
URL: https://github.com/apache/polaris/pull/3964#discussion_r2914535379
##########
site/content/in-dev/unreleased/getting-started/using-polaris/_index.md:
##########
@@ -179,7 +179,7 @@ docker attach $(docker ps -q --filter name=spark-sql)
Once the Spark session starts, we can create a namespace and table within the catalog:
```sql
-USE quickstart_catalog;
+USE polaris;
Review Comment:
this is another place where #2963 broke the quickstart. The docker-compose.yml file states "polaris" as the catalog name but the Spark block above states "quickstart_catalog".
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@polaris.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Update quickstart command [polaris]
Posted by "adnanhemani (via GitHub)" <gi...@apache.org>.
adnanhemani commented on PR #3964:
URL: https://github.com/apache/polaris/pull/3964#issuecomment-4027486659
Quickstart seems to be broken by #2963. I've opened an issue to get all pieces of this issue fixed here: #3962. This change is a step in the right direction given the changes made by #2963, but does not fix all the issues. I will start investigating the rest of the problems being seen.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@polaris.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Update quickstart command [polaris]
Posted by "viv-tong (via GitHub)" <gi...@apache.org>.
viv-tong commented on PR #3964:
URL: https://github.com/apache/polaris/pull/3964#issuecomment-4031665469
> Maybe I missed something, but from the current getting start guide, it will still point users to `https://raw.githubusercontent.com/apache/polaris/main/getting-started/quickstart/docker-compose.yml ` which is not longer a valid path due to it got moved into site dir (in this case, `https://raw.githubusercontent.com/apache/polaris/refs/heads/main/site/content/guides/quickstart/docker-compose.yml`). Then if we use the right path, it will work:
>
> ```
> polaris-setup-1 | Creating catalog 'quickstart_catalog' in realm POLARIS...
> polaris-1 | 2026-03-10 03:14:02,344 INFO [org.apa.pol.ser.adm.PolarisServiceImpl] [96ac5847-18bf-45c3-a7b6-2b4e16b8eafb_0000000000000000002,POLARIS] [,,,] (executor-thread-1) Created new catalog class PolarisCatalog {
> polaris-1 | class Catalog {
> polaris-1 | type: INTERNAL
> polaris-1 | name: quickstart_catalog
> polaris-1 | properties: class CatalogProperties {
> polaris-1 | {default-base-location=s3://bucket123}
> polaris-1 | defaultBaseLocation: s3://bucket123
> polaris-1 | }
> polaris-1 | createTimestamp: 1773112442341
> polaris-1 | lastUpdateTimestamp: 0
> polaris-1 | entityVersion: 1
> polaris-1 | storageConfigInfo: class AwsStorageConfigInfo {
> polaris-1 | class StorageConfigInfo {
> polaris-1 | storageType: S3
> polaris-1 | allowedLocations: [s3://bucket123]
> polaris-1 | }
> polaris-1 | roleArn: null
> polaris-1 | externalId: null
> polaris-1 | userArn: null
> polaris-1 | currentKmsKey: null
> polaris-1 | allowedKmsKeys: []
> polaris-1 | region: null
> polaris-1 | endpoint: http://localhost:9000
> polaris-1 | stsEndpoint: null
> polaris-1 | stsUnavailable: null
> polaris-1 | endpointInternal: http://rustfs:9000
> polaris-1 | pathStyleAccess: true
> polaris-1 | kmsUnavailable: null
> polaris-1 | }
> polaris-1 | }
> polaris-1 | }
> polaris-1 | 2026-03-10 03:14:02,349 INFO [io.qua.htt.access-log] [96ac5847-18bf-45c3-a7b6-2b4e16b8eafb_0000000000000000002,POLARIS] [,,,] (executor-thread-1) 172.18.0.4 - root [10/Mar/2026:03:14:02 +0000] "POST /api/management/v1/catalogs HTTP/1.1" 201 374
> ```
@MonkeyCanCode - Yes, we ran into this issue yesterday with the paths. @adnanhemani said he has to take a closer look as to whether updating `getting-started` to `site/content/guides` is the correct path moving forward or if `getting-started` is the intended path.
I can update the docs over the weekend if there's a consensus of what the correct path forward is.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@polaris.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Update quickstart command [polaris]
Posted by "MonkeyCanCode (via GitHub)" <gi...@apache.org>.
MonkeyCanCode commented on PR #3964:
URL: https://github.com/apache/polaris/pull/3964#issuecomment-4028321358
Maybe I missed something, but from the current getting start guide, it will still point users to `https://raw.githubusercontent.com/apache/polaris/main/getting-started/quickstart/docker-compose.yml ` which is not longer a valid path due to it got moved into site dir (in this case, `https://raw.githubusercontent.com/apache/polaris/refs/heads/main/site/content/guides/quickstart/docker-compose.yml`). Then if we use the right path, it will work:
```
polaris-setup-1 | Creating catalog 'quickstart_catalog' in realm POLARIS...
polaris-1 | 2026-03-10 03:14:02,344 INFO [org.apa.pol.ser.adm.PolarisServiceImpl] [96ac5847-18bf-45c3-a7b6-2b4e16b8eafb_0000000000000000002,POLARIS] [,,,] (executor-thread-1) Created new catalog class PolarisCatalog {
polaris-1 | class Catalog {
polaris-1 | type: INTERNAL
polaris-1 | name: quickstart_catalog
polaris-1 | properties: class CatalogProperties {
polaris-1 | {default-base-location=s3://bucket123}
polaris-1 | defaultBaseLocation: s3://bucket123
polaris-1 | }
polaris-1 | createTimestamp: 1773112442341
polaris-1 | lastUpdateTimestamp: 0
polaris-1 | entityVersion: 1
polaris-1 | storageConfigInfo: class AwsStorageConfigInfo {
polaris-1 | class StorageConfigInfo {
polaris-1 | storageType: S3
polaris-1 | allowedLocations: [s3://bucket123]
polaris-1 | }
polaris-1 | roleArn: null
polaris-1 | externalId: null
polaris-1 | userArn: null
polaris-1 | currentKmsKey: null
polaris-1 | allowedKmsKeys: []
polaris-1 | region: null
polaris-1 | endpoint: http://localhost:9000
polaris-1 | stsEndpoint: null
polaris-1 | stsUnavailable: null
polaris-1 | endpointInternal: http://rustfs:9000
polaris-1 | pathStyleAccess: true
polaris-1 | kmsUnavailable: null
polaris-1 | }
polaris-1 | }
polaris-1 | }
polaris-1 | 2026-03-10 03:14:02,349 INFO [io.qua.htt.access-log] [96ac5847-18bf-45c3-a7b6-2b4e16b8eafb_0000000000000000002,POLARIS] [,,,] (executor-thread-1) 172.18.0.4 - root [10/Mar/2026:03:14:02 +0000] "POST /api/management/v1/catalogs HTTP/1.1" 201 374
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@polaris.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Update quickstart command [polaris]
Posted by "dimas-b (via GitHub)" <gi...@apache.org>.
dimas-b commented on code in PR #3964:
URL: https://github.com/apache/polaris/pull/3964#discussion_r2911748727
##########
site/content/in-dev/unreleased/getting-started/using-polaris/_index.md:
##########
@@ -179,7 +179,7 @@ docker attach $(docker ps -q --filter name=spark-sql)
Once the Spark session starts, we can create a namespace and table within the catalog:
```sql
-USE quickstart_catalog;
+USE polaris;
Review Comment:
+1 to @adnanhemani 's points
##########
site/content/in-dev/unreleased/getting-started/using-polaris/_index.md:
##########
@@ -179,7 +179,7 @@ docker attach $(docker ps -q --filter name=spark-sql)
Once the Spark session starts, we can create a namespace and table within the catalog:
```sql
-USE quickstart_catalog;
+USE polaris;
Review Comment:
+1 to @flyrain 's points
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@polaris.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Update quickstart command [polaris]
Posted by "github-actions[bot] (via GitHub)" <gi...@apache.org>.
github-actions[bot] closed pull request #3964: Update quickstart command
URL: https://github.com/apache/polaris/pull/3964
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@polaris.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Update quickstart command [polaris]
Posted by "MonkeyCanCode (via GitHub)" <gi...@apache.org>.
MonkeyCanCode commented on PR #3964:
URL: https://github.com/apache/polaris/pull/3964#issuecomment-4043523769
> We should point all "getting-started/" references into "site/content/guides".
I think this is the only one where we are using a absolute URL. In other places such as the aws/gcp/azure ones, it is still pointing to `getting-started` but that is still valid as it is with path to the repo which we have soft link for this:
```
lrwxr-xr-x 1 yong staff 20 Mar 11 21:33 getting-started -> site/content/guides/
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@polaris.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Update quickstart command [polaris]
Posted by "flyrain (via GitHub)" <gi...@apache.org>.
flyrain commented on code in PR #3964:
URL: https://github.com/apache/polaris/pull/3964#discussion_r2914687240
##########
site/content/in-dev/unreleased/getting-started/using-polaris/_index.md:
##########
@@ -179,7 +179,7 @@ docker attach $(docker ps -q --filter name=spark-sql)
Once the Spark session starts, we can create a namespace and table within the catalog:
```sql
-USE quickstart_catalog;
+USE polaris;
Review Comment:
is this place setting the spark config? https://github.com/apache/polaris/blob/1e7bb1a6b077df4f7494925ed0a89ed7f09c3c59/getting-started/quickstart/docker-compose.yml#L269
If yes, we can add this line to there, and remove the line `USE polaris;` here.
```
--conf spark.sql.defaultCatalog=polaris
```
We may add this to line 151 anyways, so that both work. WDYT?
```
--conf spark.sql.defaultCatalog=quickstart_catalog
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@polaris.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Update quickstart command [polaris]
Posted by "github-actions[bot] (via GitHub)" <gi...@apache.org>.
github-actions[bot] commented on PR #3964:
URL: https://github.com/apache/polaris/pull/3964#issuecomment-4240876789
This PR is stale because it has been open 30 days with no activity. Remove stale label or comment or this will be closed in 5 days.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@polaris.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Update quickstart command [polaris]
Posted by "flyrain (via GitHub)" <gi...@apache.org>.
flyrain commented on code in PR #3964:
URL: https://github.com/apache/polaris/pull/3964#discussion_r2908740235
##########
site/content/in-dev/unreleased/getting-started/using-polaris/_index.md:
##########
@@ -179,7 +179,7 @@ docker attach $(docker ps -q --filter name=spark-sql)
Once the Spark session starts, we can create a namespace and table within the catalog:
```sql
-USE quickstart_catalog;
+USE polaris;
Review Comment:
I think `quickstart_catalog` is consistent with the value in the spark config above, see line 151.
Another option is to have this config in the spark config around line 151, so that we don't need the `use xxx` command.
```
--conf spark.sql.defaultCatalog=quickstart_catalog
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@polaris.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Update quickstart command [polaris]
Posted by "viv-tong (via GitHub)" <gi...@apache.org>.
viv-tong commented on code in PR #3964:
URL: https://github.com/apache/polaris/pull/3964#discussion_r2911948386
##########
site/content/in-dev/unreleased/getting-started/using-polaris/_index.md:
##########
@@ -179,7 +179,7 @@ docker attach $(docker ps -q --filter name=spark-sql)
Once the Spark session starts, we can create a namespace and table within the catalog:
```sql
-USE quickstart_catalog;
+USE polaris;
Review Comment:
@flyrain Gotcha! Thanks for the feedback! I'll take a closer look on your suggestion over the weekend.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@polaris.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] Update quickstart command [polaris]
Posted by "adnanhemani (via GitHub)" <gi...@apache.org>.
adnanhemani commented on PR #3964:
URL: https://github.com/apache/polaris/pull/3964#issuecomment-4034541486
We should point all "getting-started/" references into "site/content/guides".
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: issues-unsubscribe@polaris.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org