MonkeyCanCode commented on code in PR #4075: URL: https://github.com/apache/polaris/pull/4075#discussion_r3019564855
########## site/content/in-dev/unreleased/command-line-interface.md: ########## @@ -1571,6 +1577,113 @@ options: polaris setup export ``` +### Find + +The `find` command is used to searches for an identifier across global entities (principals, roles, catalogs) +and catalog entities (namespaces, tables, views) using fuzzy matching. + +##### Examples + +``` +polaris find my_table +polaris find ns1.ns2 +polaris find --catalog my_catalog my_table +polaris find my_table --type table +``` + +### Tables + +The `tables` command is used to manage Iceberg tables within a Polaris Catalog. + +`tables` supports the following subcommands: + +1. list +2. get +3. summarize +4. delete + +#### list + +The `list` subcommand is used to list tables within a namesace from a given catalog. + +``` +input: polaris tables list --help +options: + list + Named arguments: + --catalog The name of an existing catalog + --namespace A period-delimited namespace +``` + +##### Examples + +``` +polaris tables list +``` + +#### get + +The `get` subcommand retrieves the table metadata for a specific table. + +``` +input: polaris tables get --help +options: + get + Named arguments: + --catalog The name of an existing catalog + --namespace A period-delimited namespace + Positional arguments: + table +``` + +##### Examples + +``` +polaris tables get my_table --catalog my_catalog --namespace ns1 +``` + +#### summarize + +The `summarize` subcommand provides a detail overview of a table. + +``` +input: polaris tables summarize --help +options: + summarize + Named arguments: + --catalog The name of an existing catalog + --namespace A period-delimited namespace + Positional arguments: + table +``` + +##### Examples + +``` +polaris tables summarize my_table --catalog my_catalog --namespace ns1 +``` + +#### delete + +The `delete` subcommand de-registers a table from catalog (metadata-only deletion). + +``` +input: polaris tables delete --help +options: + delete + Named arguments: + --catalog The name of an existing catalog + --namespace A period-delimited namespace + Positional arguments: + table +``` + +##### Examples + +``` +polaris tables delete my_table --catalog my_catalog --namesapce ns1 Review Comment: Resolved. -- 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: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
