# @comunica/actor-query-source-identify-hypermedia-sparql 中文文档

规范地址：https://npmcn.com/package/%40comunica/actor-query-source-identify-hypermedia-sparql/

版本：5\.4\.0
npm 元数据更新时间：2026-10-22T07:37:23.422Z
中文译文更新时间：2026-11-10T14:35:05.270Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40comunica/actor-query-source-identify-hypermedia-sparql
原文对照：https://npmcn.com/package/%40comunica/actor-query-source-identify-hypermedia-sparql/?lang=original
项目主页：https://comunica.dev/
源码仓库：https://github.com/comunica/comunica

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：156 kB，16 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：16 个
- 首次发布：2024-02-09T12:33:10.991Z
- 最新版本发布：2026-09-14T09:14:26.893Z
- 近 30 天下载量：69269（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：31（近 12 个月 12 个）

## 中文简介

一个 sparql 查询- 源码识别- 高速媒体 演员

## 安装

```sh
npm install @comunica/actor-query-source-identify-hypermedia-sparql
```

也可以使用：`pnpm add @comunica/actor-query-source-identify-hypermedia-sparql`、`yarn add @comunica/actor-query-source-identify-hypermedia-sparql`、`bun add @comunica/actor-query-source-identify-hypermedia-sparql`

## README

# Comunica SPARQL 查询源识别超媒体演员

[![npm version](https://badge.fury.io/js/%40comunica%2Factor-query-source-identify-hypermedia-sparql.svg)](https://www.npmjs.com/package/@comunica/actor-query-source-identify-hypermedia-sparql)

A 类 [查询源识别超媒体](https://github.com/comunica/comunica/tree/master/packages/bus-query-source-identify-hypermedia) 处理的演员 [SPARQL 端点](https://www.w3.org/TR/sparql11-protocol/)。 。 。 .

这个模块是 [通信框架](https://github.com/comunica/comunica), (中文(简体) ), 并且只能用于 [想要建立自己的查询引擎的开发者](https://comunica.dev/docs/modify/)。 。 。 .

[如果您想要询问Comunica, 请点击这里](https://comunica.dev/docs/query/)。 。 。 .

## 安装

```bash
$ yarn add @comunica/actor-query-source-identify-hypermedia-sparql
```

## 配置

安装后,此软件包可以添加到您的引擎配置中如下:

```text
{
  "@context": [
    ...
    "https://linkedsoftwaredependencies.org/bundles/npm/@comunica/actor-query-source-identify-hypermedia-sparql/^1.0.0/components/context.jsonld"
  ],
  "actors": [
    ...
    {
      "@id": "urn:comunica:default:query-source-identify-hypermedia/actors#sparql",
      "@type": "ActorQuerySourceIdentifyHypermediaSparql",
      "mediatorHttp": { "@id": "urn:comunica:default:http/mediators#main" },
      "mediatorMergeBindingsContext": { "@id": "urn:comunica:default:merge-bindings-context/mediators#main" },
      "mediatorQuerySerialize": { "@id": "urn:comunica:default:query-serialize/mediators#main" },
      "sparqlServerSoftwarePatterns": ["Virtuoso", "Fuseki"]
    }
  ]
}
```

### 配置参数

-   `mediatorHttp`调解人: [HTTP 总线](https://github.com/comunica/comunica/tree/master/packages/bus-http)。 。 。 .
-   `mediatorMergeBindingsContext`调解人: [合并绑定上下文总线](https://github.com/comunica/comunica/tree/master/packages/bus-merge-bindings-context)。 。 。 .
-   `mediatorQuerySerialize`调解人: [查询序列化总线](https://github.com/comunica/comunica/tree/master/packages/bus-query-serialize)。 。 。 .
-   `checkUrlSuffix`: 如果以“ / sparql” 结尾的 URL 也应被视为 SPARQL 端点, 默认为 `true`。 。 。 .
-   `forceHttpGet`:如果查询要通过 HTTP GET 而不是 POST 发送,默认为 `false`。 。 。 .
-   `forceSourceType`: 强制提供的所有来源被解释为SPARQL端点,默认为 `false`。 。 。 .
-   `cacheSize`: COUNT 查询的缓存大小,默认为 `1024`。 。 。 .
-   `bindMethod`: 用于通信绑定、默认的查询操作 `'values'`,备选案文: `'union'` 或者说 `'filter'`。 。 。 .
-   `countTimeout`: 计数查询允许用多长的时间, 以毫秒计的超时. 如果超时了, 则返回一个无限重心 。 默认为 `3000`。 。 。 .
-   `cardinalityCountQueries`:如果发送计数查询以获得(分)计数的临界值。 如果设定为虚假,由此产生的基本因素将永远被认为是无限的。 默认为 `true`
-   `cardinalityEstimateConstruction`:如果大型查询的临界值估计数应尽可能从地(子)临界值得出。 默认为 `false`。如果设置为虚假,则会为各级的每个操作发送计数查询.
-   `sparqlServerSoftwarePatterns`: 对齐正则表达式的可选列表 `Server` HTTP 响应头. 如果找到匹配,则源被识别为SPARQL端点.

## 端点服务器头报告

观测到以下终点返回: `Server` 页眉( 撰写时):

| 终点 | 服务器头 |
| --- | --- |
| [http://lod.sztaki.hu/sparql (中文(简体) )](http://lod.sztaki.hu/sparql) | `Virtuoso/06.01.3127 (Linux) i686-pc-linux-gnu` |
| [http://linguistic.linkdata.es/sparql 页面存档备份,存于互联网档案馆](http://linguistic.linkeddata.es/sparql) | `Virtuoso/06.01.3127 (Linux) x86_64-pc-linux-gnu` |
| [http://www.genome.jp/sparql/linkdb 页面存档备份,存于互联网档案馆](http://www.genome.jp/sparql/linkdb) | `Virtuoso/07.20.3217 (Linux) x86_64-unknown-linux-gnu` |
| [http://sparql.archives-ouvertes.fr/sparql 页面存档备份,存于互联网档案馆](http://sparql.archives-ouvertes.fr/sparql) | `Virtuoso/07.20.3229 (Linux) x86_64-pc-linux-gnu` |
| [http://data.persee.fr/sparql 页面存档备份,存于互联网档案馆](http://data.persee.fr/sparql) | `Virtuoso/07.20.3230 (Linux) x86_64-generic_glibc25-linux-gnu` |
| [http://linkgeodata.org/sparql 互联网档案馆的存檔,存档日期2013-12-21](http://linkedgeodata.org/sparql) | `Virtuoso/07.20.3233 (Linux) x86_64-pc-linux-gnu` |
| [http://kaiko.getalp.org/sparql (中文(简体) )](http://kaiko.getalp.org/sparql) | `Virtuoso/07.20.3240 (Linux) x86_64-pc-linux-gnu` |
| [http://data.cervantesvirtual.com/openrdf-sesame/repositories/data 互联网档案馆的存檔,存档日期2014-12-22](http://data.cervantesvirtual.com/openrdf-sesame/repositories/data) | `Virtuoso/07.20.3240 (Linux) x86_64-pc-linux-gnu` |
| [http://sparql.hegroup.org/sparql/ 页面存档备份,存于互联网档案馆](http://sparql.hegroup.org/sparql/) | `Virtuoso/07.20.3241 (Linux) x86_64-pc-linux-gnu` |
| [http://dbpedia.org/sparql (中文(简体) )](http://dbpedia.org/sparql) | `Virtuoso/08.03.3334 (Linux) x86_64-ubuntu_noble-linux-glibc2.39 VDB` |
| [https://lov.linkdata.es/dataset/lov/sparql 互联网档案馆的存檔,存档日期2013-12-02](https://lov.linkeddata.es/dataset/lov/sparql) | `Fuseki (1.1.1)` |
| [http://lov.okfn.org/endpoint/lov 页面存档备份,存于互联网档案馆](http://lov.okfn.org/endpoint/lov) | `Fuseki (1.1.1)` |

## 常见问题

### @comunica/actor-query-source-identify-hypermedia-sparql 是什么？

一个 sparql 查询- 源码识别- 高速媒体 演员

### 如何安装 @comunica/actor-query-source-identify-hypermedia-sparql？

在项目目录运行 npm install @comunica/actor-query-source-identify-hypermedia-sparql，或使用 pnpm add / yarn add / bun add。

### @comunica/actor-query-source-identify-hypermedia-sparql 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @comunica/actor-query-source-identify-hypermedia-sparql 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @comunica/actor-query-source-identify-hypermedia-sparql 可以商用吗？

@comunica/actor-query-source-identify-hypermedia-sparql 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @comunica/actor-query-source-identify-hypermedia-sparql 的下载量有多少？

根据 npm 官方下载统计，@comunica/actor-query-source-identify-hypermedia-sparql 在 2026/10/11 – 2026/11/09 这 30 天内被下载 69,269 次，日均约 2,309 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @comunica/actor-query-source-identify-hypermedia-sparql 还在维护吗？

最新版本 5\.4\.0 发布于 2026/09/14（1 个月前）；至今共发布 31 个版本，其中过去 12 个月发布了 12 个；首次发布于 2024/02/09。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

