7.2.11 lsdataset

List Exascale datasets.

Syntax

lsdataset [ -d | --detail ] [ -h ] [ --vault vault ] [ dataset-ID ]
          [{ -w | --wallet } wallet-location ] 
          [{ -T | --trace } trace-level ]
          [{ -j | --json } [ --compact ]]

Command Options

The options for the ls command are:

• dataset-ID: The identifier for a dataset that you want to display information about.

  Each system-defined dataset has a unique composite identifier, which contains unique identifiers for the associated entities. The dataset identifier has one of the following formats:

  • @Vault-name: Identifies the vault-level dataset for a specific named vault.

  • @Vault-name:GI-cluster-ID: Identifies the dataset for a specific Oracle Grid Infrastructure (GI) cluster, which consumes storage space in the specified vault.

  • @Vault-name:GI-cluster-ID:CDB-ID: Identifies the dataset for a specific Oracle multitenant container database (CDB) that belongs to the specified GI cluster.

  • @Vault-name:GI-cluster-ID:CDB-ID:PDB-ID: Identifies the dataset for an Oracle pluggable database (PDB) that is associated with the specified CDB, GI cluster, and vault.

  The percent symbol (%) can be used for wildcard searches. For example, @Vault-name:GI-cluster-ID:% displays information about all CDB datasets associated with the specified GI cluster and vault.

  If dataset-ID is not specified, the command displays information about all datasets.

• --vault: Displays information for datasets in the specified vault.

• -d, --detail: Displays a detailed listing of attributes.

• -h: Displays output values in a human readable format (for example, 10M, 22K, 300G, and so on).

• -w, --wallet: Optionally specifies the path to the Exascale wallet directory.

• -T, --trace: Optionally enables tracing, with the trace level (trace-level) set to 1 (minimum tracing), 2 (medium tracing), or 3 (maximum tracing). If the trace level is not specified, then minimum tracing is enabled by default.

  The trace file is written to the first accessible location in the following list:

  1. If the $ADR_BASE environment variable is set:

     $ADR_BASE/diag/EXC/xsh_<user-name>/<host-name>/trace/xsh_<date>.trc

  2. /var/log/oracle/diag/EXC/xsh_<user-name>/<host-name>/trace/xsh_<date>.trc

  3. /tmp/diag/EXC/xsh_<user-name>/<host-name>/trace/xsh_<date>.trc

• -j, --json: Displays the output in JSON format.

• --compact: Displays JSON formatted output in a compact format, without white space and line breaks.

Examples

Example 7-22 List all Exascale datasets

The following example lists all datasets visible to the Exascale user associated with the XSH command invocation.

$ xsh lsdataset

Example 7-23 List datasets in an Exascale vault

The following examples list the datasets contained in the @my-data vault.

$ xsh lsdataset --vault @my-data

$ xsh lsdataset @my-data:%