全部产品
Search
文档中心

云原生数据库 PolarDB:DescribeKnowledgeSpaceAttribute - 查看知识空间详情

更新时间:Sep 24, 2026

查询知识空间详情

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

polardb:DescribeKnowledgeSpaceAttribute

get

*全部资源

*

无 无

请求语法

POST  HTTP/1.1

请求参数

名称

类型

必填

描述

示例值

KnowledgeSpaceId

string

是

知识空间唯一标识

pks-xxxx

RegionId

string

是

地域 ID

cn-beijing

返回参数

名称

类型

描述

示例值

object

Schema of Response

RequestId

string

Id of the request

6BD9CDE4-5E7B-4BF3-9BB8-83C73E******

KnowledgeSpaceId

string

知识空间唯一标识

pks-xxxxxx

Name

string

空间名称

testName

Description

string

空间备注

testDesc

DBClusterId

string

PolarDB 实例 ID

pc-*************

DBName

string

数据库名

polar_rag_meta

DBType

string

数据库引擎类型

  • MySQL

  • PostgreSQL

MySQL

ACLMode

string

知识空间 ACL 模式。取值:DISABLED、ENFORCED。

ENFORCED

Status

string

实例状态

Activation

EmbeddingModel

string

向量模型

text-embedding-v4

EmbeddingDimension

integer

向量维度

1536

RerankModel

string

排序模型

qwen3-rerank

LLMModel

string

大语言模型

qwen3.6-plus

Strategy

string

分片策略

hybrid

ShardSize

integer

分片大小(token)

512

ShardingStrategyConfig

object

知识空间默认分块策略配置。存量对象未保存完整配置时可能为空。

DefaultStrategy

object

默认分块策略。没有规则命中时使用该策略。

Type

string

默认分块策略类型。取值:hybrid 或 hierarchical。

hybrid

Parameters

object

参数详情。

MaxTokens

integer

单个分片的最大 Token 数量。

512

MergePeers

boolean

是否合并同一标题下相邻的小分片。

true

Rules

array<object>

按顺序匹配的覆盖规则列表。

array<object>

Match

object

内容类型。当前支持 table。

ContentType

string

内容类型。当前支持 table。

table

Strategy

object

分片策略

Type

string

规则命中后的分块策略类型。

hierarchical

Parameters

object

参数详情

MaxTokens

integer

命中内容的单个分片最大 Token 数量。

512

MarkdownTables

string

Markdown 表格处理模式。取值:auto、on 或 off。

auto

KnowledgeBaseCount

integer

知识库总数

1

TotalDocs

integer

文档总数

1

TotalSizeBytes

integer

总字节数

318881

CreationTime

string

创建时间

时间采用 ISO 8601 格式,时区为 UTC(格式:YYYY-MM-DDTHH:mm:ssZ)。

2026-06-25T09:53:44Z

OSSBucket

string

OSS Bucket

test-bucket

示例

正常返回示例

JSON格式

{
  "RequestId": "6BD9CDE4-5E7B-4BF3-9BB8-83C73E******",
  "KnowledgeSpaceId": "pks-xxxxxx",
  "Name": "testName",
  "Description": "testDesc",
  "DBClusterId": "pc-*************",
  "DBName": "polar_rag_meta",
  "DBType": "MySQL",
  "ACLMode": "ENFORCED",
  "Status": "Activation",
  "EmbeddingModel": "text-embedding-v4",
  "EmbeddingDimension": 1536,
  "RerankModel": "qwen3-rerank",
  "LLMModel": "qwen3.6-plus",
  "Strategy": "hybrid",
  "ShardSize": 512,
  "ShardingStrategyConfig": {
    "DefaultStrategy": {
      "Type": "hybrid",
      "Parameters": {
        "MaxTokens": 512,
        "MergePeers": true
      }
    },
    "Rules": [
      {
        "Match": {
          "ContentType": "table"
        },
        "Strategy": {
          "Type": "hierarchical",
          "Parameters": {
            "MaxTokens": 512,
            "MarkdownTables": "auto"
          }
        }
      }
    ]
  },
  "KnowledgeBaseCount": 1,
  "TotalDocs": 1,
  "TotalSizeBytes": 318881,
  "CreationTime": "2026-06-25T09:53:44Z",
  "OSSBucket": "test-bucket"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情。