List table metadata (TypeScript)

Gets information about the tables in a keyspace.

Ready to write code? See the examples for this method to get started. If you are new to the Data API, check out the quickstart.

Result

Returns a promise that resolves to an unordered list of FullTableInfo objects that describe each table.

Parameters

Use the listTables method, which belongs to the Db class.

Method signature
async listTables(
  options?: {
    nameOnly?: false,
    keyspace?: string,
    timeout?: number | TimeoutDescriptor,
  },
): TableDescriptor[]
Name Type Summary

options

ListTablesOptions

Optional. The options for this operation. See Properties of options for more details.

Properties of options
Name Type Summary

nameOnly

false

Must be false or undefined to return metadata about the tables. Otherwise, only the table names are returned.

keyspace

string

Optional if you specified a working keyspace when you created the Db object. The keyspace to inspect.

Default: The working keyspace set when you created the Db object, if one was provided.

timeout

number | TimeoutDescriptor

Optional. A timeout to impose on the underlying API request.

Examples

The following examples demonstrate how to list table metadata.

List table metadata

import {
  DataAPIClient,
  UsernamePasswordTokenProvider,
} from "@datastax/astra-db-ts";

// Get a database
const client = new DataAPIClient({ environment: "hcd" });
const database = client.db("API_ENDPOINT", {
  token: new UsernamePasswordTokenProvider("USERNAME", "PASSWORD"),
  keyspace: "KEYSPACE_NAME",
});

// List table metadata
(async function () {
  const result = await database.listTables();

  console.log(result);
})();

Client reference

For more information, see the client reference.

Was this helpful?

Give Feedback

How can we improve the documentation?

© Copyright IBM Corporation 2026 | Privacy policy | Terms of use Manage Privacy Choices

Apache, Apache Cassandra, Cassandra, Apache Tomcat, Tomcat, Apache Lucene, Apache Solr, Apache Hadoop, Hadoop, Apache Pulsar, Pulsar, Apache Spark, Spark, Apache TinkerPop, TinkerPop, Apache Kafka and Kafka are either registered trademarks or trademarks of the Apache Software Foundation or its subsidiaries in Canada, the United States and/or other countries. Kubernetes is the registered trademark of the Linux Foundation.

General Inquiries: Contact IBM