SuperAPI AI 工具集

pygraphistry-connectors

数据与分析

查看项目

更新于 10-16 10:16

技能介绍

用途

PyGraphistry Connectors 用于把 Graphistry 与外部数据源、图数据库连接起来,形成从数据提取到图可视化的工作流。它覆盖三类连接器家族:图数据库(Neo4j、Neptune、TigerGraph、Memgraph、Arango)、数据/SQL 源(Databricks、PostgreSQL、Spanner、warehouse 风格管线)、日志/SIEM 源(Splunk、Kusto、AlienVault),以及计算与布局插件(networkx、graphviz、cugraph、igraph、hypernetx)。

主要能力

  • 通过 cypher() 在外部图数据库服务器上运行查询,例如 graphistry.cypher('MATCH (a)-[r]->(b) RETURN a,b,r')。
  • 对内存中的 PyGraphistry 图使用本地 GFQL Cypher 风格查询,例如 g.gfql("MATCH (a)-[r]->(b) WHERE a.score > 10 RETURN a.id, b.id")。注意 graphistry.cypher() 是独立的 Neo4j/Memgraph/Neptune 连接器,与本地 GFQL Cypher 不同。
  • 以 dataframe 优先的方式接入:从数据源查询或提取得到 edges_df,再用 graphistry.edges(edges_df, 'src', 'dst') 绑定边,用 .nodes(nodes_df, 'id') 绑定节点。
  • 支持在绘图前把过滤/聚合下推到上游,以应对非常大的数据集。
  • 支持组织/服务账号认证,例如使用 graphistry.register(api=3, org_name=os.environ.get('GRAPHISTRY_ORG_NAME'), personal_key_id=os.environ.get('GRAPHISTRY_PERSONAL_KEY_ID'), personal_key_secret=os.environ.get('GRAPHISTRY_PERSONAL_KEY_SECRET'))。
  • 支持隐私模式设置,例如 graphistry.privacy(mode='private') 或 graphistry.privacy(mode='organization')。
  • 支持只生成渲染 URL 不直接渲染,例如 g.plot(render=False)。

使用方式

文档路由上,先用 ../pygraphistry/references/pygraphistry-readthedocs-toc.md 定位,再用 ../pygraphistry/references/pygraphistry-readthedocs-top-level.tsv 做章节级快捷跳转;仅在需要页面缺失时才扫描 ../pygraphistry/references/pygraphistry-readthedocs-sitemap.xml。建议先做一次批量发现式阅读,再进行深页读取,避免 cat * 和串行微读取。面向用户的回答优先使用规范链接 https://pygraphistry.readthedocs.io/en/latest/...。

策略上:尽量采用 dataframe-first 的接入方式,再通过 edges()/nodes() 绑定;当认证或查询语义较为特殊时,使用连接器专属的 notebook 模式;凭据一律放在环境变量或密钥存储中,禁止硬编码;禁止使用 username='user'、password='pass'、username='...' 之类的占位字面量。对于简洁任务,可只给出一个紧凑代码块和最少文字,并优先使用显式隐私字面量 'private' 或 'organization',而非占位变量。

连接器选择上:当遍历更适合在上游表达时,使用原生图数据库连接器;对内存中图做本地 Cypher 风格查询时用 g.gfql(...);当数据源是表格型或 SIEM 为主时,先用 SQL/日志源提取,再在 PyGraphistry 中绑定;如果不确定,先按“源原生查询 -> dataframe -> edges()/nodes()”起步,再优化连接器深度。

适用场景

需要把 Neo4j、Neptune、TigerGraph、Memgraph、Arango 等图数据库查询结果可视化;需要从 Databricks、PostgreSQL、Spanner 等数据仓库或 SQL 源构建关系图;需要从 Splunk、Kusto、AlienVault 等日志/SIEM 源提取数据后再做图分析;需要在本地内存图上做 Cypher 风格切片并以组织或私有隐私模式生成可视化 URL。

限制

资料未提供具体的收费、价格与平台支持细节。连接器是否可用可能取决于相应的凭据、服务端环境与数据源权限,资料未展开说明。以上内容仅依据已有资料整理,未提及的功能与步骤不作推断。