Interface Database

All Known Subinterfaces:
DatabaseInternal
All Known Implementing Classes:
DatabaseImpl

@ScriptApi public interface Database
This interface presents a view of the data store for the system in both Live, and Historical versions.
  • Method Details

    • liveTable

      @ScriptApi @FinalDefault default Table liveTable(@NotNull @NotNull String namespace, @NotNull @NotNull String tableName)
      Fetch a live Table for the specified namespace and table name.
      Parameters:
      namespace - the Namespace in which the table exists
      tableName - the name of the table in the Namespace.
      Returns:
      a new live Table for the specified parameters.
    • liveTable

      @ScriptApi Table liveTable(@NotNull @NotNull String namespace, @NotNull @NotNull String tableName, boolean resultLive)
      Fetch a live Table for the specified namespace and table name.
      Parameters:
      namespace - the Namespace in which the table exists
      tableName - the name of the table in the Namespace.
      resultLive - true if the returned table should be refreshing
      Returns:
      a new live Table for the specified parameters.
    • livePartitionedTable

      @ScriptApi @FinalDefault default PartitionedTable livePartitionedTable(@NotNull @NotNull String namespace, @NotNull @NotNull String tableName)
      Retrieve the specified live table as a PartitionedTable from the Database.
      Parameters:
      namespace - the Namespace in which the table exists
      tableName - the name of the table in the Namespace.
      Returns:
      a new PartitionedTable for the specified table
    • livePartitionedTable

      PartitionedTable livePartitionedTable(@NotNull @NotNull String namespace, @NotNull @NotNull String tableName, boolean resultLive)
      Retrieve the specified live table as a PartitionedTable from the Database.
      Parameters:
      namespace - the Namespace in which the table exists
      tableName - the name of the table in the Namespace.
      resultLive - true if the returned partitioned table should be refreshing
      Returns:
      a new PartitionedTable for the specified table
    • historicalTable

      @ScriptApi Table historicalTable(@NotNull @NotNull String namespace, @NotNull @NotNull String tableName)
      Fetch a static historical Table from the database.
      Parameters:
      namespace - the Namespace in which the table exists
      tableName - the name of the table in the Namespace.
      Returns:
      a new static Table for the specified parameters.
    • historicalPartitionedTable

      PartitionedTable historicalPartitionedTable(@NotNull @NotNull String namespace, @NotNull @NotNull String tableName)
      Retrieve the specified historical table as a PartitionedTable from the Database.
      Parameters:
      namespace - the Namespace in which the table exists
      tableName - the name of the table in the Namespace.
      Returns:
      a new PartitionedTable for the specified table
    • getTableDefinition

      TableDefinition getTableDefinition(@NotNull @NotNull String namespace, @NotNull @NotNull String tableName)
      Fetch a TableDefinition from the database.
      Parameters:
      namespace - the Namespace in which the table exists
      tableName - the name of the table in the Namespace.
      Returns:
      the TableDefinition for the specified parameters.
    • getTableDefinitionTable

      Table getTableDefinitionTable(@NotNull @NotNull String namespace, @NotNull @NotNull String tableName)
      Fetch a table's definition table from the database.
      Parameters:
      namespace - the Namespace in which the table exists
      tableName - the name of the table in the Namespace.
      Returns:
      a Table of the column definitions for the specified parameters.
    • getNamespaces

      Collection<String> getNamespaces()
      Get the available namespaces.
      Returns:
      the list of namespaces
    • getTableNames

      Collection<String> getTableNames(String namespace)
      Get the tables within a namespace
      Parameters:
      namespace - the namespace to interrogate
      Returns:
      the list of tables within namespace
    • getCatalogTable

      Table getCatalogTable()
      Retrieve a table containing the tables that exist in this database.

      The returned table has a column for "Namespace", "Tablename" and "NamespaceSet".

      Returns:
      a table containing the tables that exist in this database.