SupportsNamespaces

Author: jaceklaskowski

docs/CatalogImpl.md

@@ -14,9 +14,9 @@
 
 * `SparkSession` is requested for the [Catalog](SparkSession.md#catalog)
 
-## <span id="listColumns"> listColumns
+## listColumns { #listColumns }
 
-??? note "Signature"
+??? note "Catalog"
 
     ```scala
     listColumns(
@@ -34,9 +34,9 @@
 
 In the end, `listColumns` [makeDataset](#makeDataset) with the columns.
 
-## <span id="getTable"> getTable
+## getTable { #getTable }
 
-??? note "Signature"
+??? note "Catalog"
 
     ```scala
     getTable(
@@ -50,7 +50,7 @@ In the end, `listColumns` [makeDataset](#makeDataset) with the columns.
 
 `getTable`...FIXME
 
-## <span id="makeTable"> Looking Up Table
+## Looking Up Table { #makeTable }
 
 ```scala
 makeTable(
@@ -66,7 +66,7 @@ makeTable(
 
 * `CatalogImpl` is requested to [listTables](#listTables) and [getTable](#getTable)
 
-### <span id="loadTable"> loadTable
+### loadTable { #loadTable }
 
 ```scala
 loadTable(
@@ -76,6 +76,22 @@ loadTable(
 
 `loadTable`...FIXME
 
+## getNamespace { #getNamespace }
+
+```scala
+getNamespace(
+  catalog: CatalogPlugin,
+  ns: Seq[String]): Database
+```
+
+`getNamespace`...FIXME
+
+---
+
+`getNamespace` is used when:
+
+* `CatalogImpl` is requested to [getDatabase](#getDatabase) and [listDatabases](#listDatabases)
+
 <!---
 ## Review Me
 

docs/connector/catalog/SupportsNamespaces.md

@@ -1,3 +1,40 @@
 # SupportsNamespaces
 
-`SupportsNamespaces` is...FIXME
+`SupportsNamespaces` is an [extension](#contract) of the [CatalogPlugin](CatalogPlugin.md) abstraction for [catalogs with namespace support](#implementations).
+
+## Contract (Subset)
+
+### listNamespaces { #listNamespaces }
+
+```java
+String[][] listNamespaces()
+```
+
+Lists the top-level namespaces from this catalog
+
+Used when:
+
+* `DelegatingCatalogExtension` is requested to [listNamespaces](DelegatingCatalogExtension.md#listNamespaces)
+* `SHOW NAMESPACES` command is executed
+
+### loadNamespaceMetadata { #loadNamespaceMetadata }
+
+```java
+Map<String, String> loadNamespaceMetadata(
+  String[] namespace)
+```
+
+Loads metadata properties for the namespace
+
+Used when:
+
+* `DelegatingCatalogExtension` is requested to [loadNamespaceMetadata](DelegatingCatalogExtension.md#loadNamespaceMetadata)
+* `SupportsNamespaces` is requested to [namespaceExists](#namespaceExists)
+* `DESCRIBE NAMESPACE` command is executed
+* `CatalogImpl` is requested to [getNamespace](../../CatalogImpl.md#getNamespace)
+
+## Implementations
+
+* [CatalogExtension](CatalogExtension.md)
+* [JDBCTableCatalog](../../jdbc/JDBCTableCatalog.md)
+* [V2SessionCatalog](../../V2SessionCatalog.md)