# Spark库表元数据查询
#### 功能说明
本节操作介绍使用AI DataLake SDK查询库表等元数据。
#### 前提条件
LakeFormationAPI和相关权限已配置，权限详情可参考[权限和授权项](https://support.huaweicloud.com/api-lakeformation/lakeformation_04_0021.html)。
#### 函数
AIDataLakeLakeFormationClient
```
# 列举Catalogs
listCatalogs();
# 列举Databases
listDatabases("yourCatalogName");
# 列举Tables
listTables("yourCatalogName", "yourDBName");
```
| 参数            | 必须配置 | 默认值 | 描述     |
|:---|:---|:---|:---|
| yourCatalogName | 否    | 无    | 数据目录名称。 |
| yourDBName   | 是    | 无    | 数据库名称。  |
   
#### 样例代码
- 查询Catalog
  ```
  public static void listCatalogs(AIDataLakeLakeFormationClient lakeformationClient) {
      Catalogs catalogs = lakeformationClient.listCatalogs();
      for (Catalog item : catalogs) {
          System.out.println(item.getCatalogName());
      }
      Catalog catalog = catalogs.getCatalog("yourCatalogName")
  }
  ```
  

- 查询数据库
  ```
  public static void listDatabases(AIDataLakeLakeFormationClient lakeformationClient) {
      Databases databases = lakeformationClient.listDatabases("yourCatalogName");
      for (Database item : databases) {
          System.out.println(item.getDatabaseName());
      }
      Database database = databases.getDatabase("yourDBName")
  }
  ```
  

- 查询表
  ```
  public static void listTables(AIDataLakeLakeFormationClient lakeformationClient) throws AIDataLakeException {
      Tables tables = lakeformationClient.listTables("yourCatalogName", "yourDBName");
      for (Table item : tables) {
          System.out.println(item.getTableName());
      }
      // get table
      Table table = tables.getTable("yourTableName");
      // filter table
      TableFilter tableFilter = new TableFilter();
      tableFilter.setTblPattern("table_name_xxx");
      tableFilter.setTblPattern("table_type_xxx");
      Iterable<Table> tableA = tables.iterableWithDatabaseAndFilter("yourDBName", tableFilter);
      // get table meta
      TableMeta tableMeta = tables.getTableMeta("yourTableName");
  }
  ```
  
 
