SHOW PACKAGES IN ARTIFACT REPOSITORY¶

Note

This command works only for an APPLICATION artifact repository.

See also:: CREATE ARTIFACT REPOSITORY , ALTER ARTIFACT REPOSITORY , DESCRIBE ARTIFACT REPOSITORY , DROP ARTIFACT REPOSITORY , SHOW ARTIFACT REPOSITORIES , SHOW VERSIONS IN ARTIFACT REPOSITORY

Syntax¶

SHOW PACKAGES [ LIKE '<pattern>' ]
              IN ARTIFACT REPOSITORY <name>
              [ LIMIT <rows> ]

LIKE 'pattern': Filters the output by package name. The match uses SQL LIKE pattern matching (case-insensitive) and is applied before LIMIT.
name: Specifies the identifier of the artifact repository.

If the identifier contains spaces or special characters, the entire string must be enclosed in double quotes. Identifiers enclosed in double quotes are also case-sensitive.

For more information, see Identifier requirements.
LIMIT rows: Limits the maximum number of rows returned. rows must be a positive integer. The command doesn’t support LIMIT ... FROM.

The command returns one row per package, in package name order:

Column	Description
`created_on`	Earliest creation time among the versions included in the row.
`name`	Package name.
`updated_on`	Latest update time among the versions included in the row.
`comment`	Comment on the version included in the row that was created most recently.

A role used to execute this operation must have the following privileges at a minimum:

Privilege	Object	Notes
USAGE	Artifact repository	Required to list packages in the repository.

Operating on an object in a schema requires at least one privilege on the parent database and at least one privilege on the parent schema.

For instructions on creating a custom role with a specified set of privileges, see Creating custom roles.

For general information about roles and privilege grants for performing SQL actions on securable objects, see Overview of Access Control.

List the packages in an artifact repository:

SHOW PACKAGES IN ARTIFACT REPOSITORY my_app_repo;

List packages whose names start with app_, and return at most 10 rows:

SHOW PACKAGES LIKE 'app_%' IN ARTIFACT REPOSITORY my_db.my_schema.my_app_repo LIMIT 10;