Ng X d dl mZ d dlZd dlmZmZmZmZ erd dlZ G d d Z dS ) ) annotationsN)
TYPE_CHECKINGListOptionalUnionc e Zd ZdZ ddd Zedd
ZddZeddd Zed d Z d dZ
e d d Z d dZ
dS ) OntotextGraphDBGrapha Ontotext GraphDB https://graphdb.ontotext.com/ wrapper for graph operations.
*Security note*: Make sure that the database connection uses credentials
that are narrowly-scoped to only include necessary permissions.
Failure to do so may result in data corruption or loss, since the calling
code may attempt commands that would result in deletion, mutation
of data if appropriately prompted or reading sensitive data if such
data is present in the database.
The best way to guard against such negative outcomes is to (as appropriate)
limit the permissions granted to the credentials used with this tool.
See https://python.langchain.com/docs/security for more information.
Nquery_endpointstrquery_ontology
Optional[str]
local_filelocal_file_formatreturnNonec 6 |r|rt d |s|st d ddl}ddlm} n # t $ r t d w xY w| }| | }| | |j |dd | _ |
|r| || } n*| | |
| } | d
| _ dS ) a+
Set up the GraphDB wrapper
:param query_endpoint: SPARQL endpoint for queries, read access
If GraphDB is secured,
set the environment variables 'GRAPHDB_USERNAME' and 'GRAPHDB_PASSWORD'.
:param query_ontology: a `CONSTRUCT` query that is executed
on the SPARQL endpoint and returns the KG schema statements
Example:
'CONSTRUCT {?s ?p ?o} FROM WHERE {?s ?p ?o}'
Currently, DESCRIBE queries like
'PREFIX onto:
PREFIX rdfs:
DESCRIBE ?term WHERE {
?term rdfs:isDefinedBy onto:
}'
are not supported, because DESCRIBE returns
the Symmetric Concise Bounded Description (SCBD),
i.e. also the incoming class links.
In case of large graphs with a million of instances, this is not efficient.
Check https://github.com/eclipse-rdf4j/rdf4j/issues/4857
:param local_file: a local RDF ontology file.
Supported RDF formats:
Turtle, RDF/XML, JSON-LD, N-Triples, Notation-3, Trig, Trix, N-Quads.
If the rdf format can't be determined from the file extension,
pass explicitly the rdf format in `local_file_format` param.
:param local_file_format: Used if the rdf format can't be determined
from the local file extension.
One of "json-ld", "xml", "n3", "turtle", "nt", "trig", "nquads", "trix"
Either `query_ontology` or `local_file` should be passed.
z2Both file and query provided. Only one is allowed.z1Neither file nor query provided. One is required.r N) sparqlstorezTCould not import rdflib python package. Please install it with `pip install rdflib`.)authnone)
identifierbind_namespacesturtleformat)
ValueErrorrdflibrdflib.plugins.storesr ImportError _get_auth SPARQLStoreopenGraphgraph_check_connectivity _load_ontology_schema_from_file_validate_user_query _load_ontology_schema_with_query serializeschema)
selfr
r r r r r r storeontology_schema_graphs
m/var/www/html/ai-engine/env/lib/python3.11/site-packages/langchain_community/graphs/ontotext_graphdb_graph.py__init__z OntotextGraphDBGraph.__init__ ss X Sj S QRR R Rj R PQQ Q MMM 9 9 9 9 9 9 9 ?
~~ ''T'22
>"""!V\%D&QQQ
""" $($H$H!% % ! !
% %n 5 5 5$($I$I % % ! ,55X5FF s
3 A
Union[tuple, None]c t j dd } t j dd }| r|st d | |fS dS )z@
Returns the basic authentication configuration
GRAPHDB_USERNAMENGRAPHDB_PASSWORDzREnvironment variable 'GRAPHDB_USERNAME' is set, but 'GRAPHDB_PASSWORD' is not set.)osenvirongetr )usernamepasswords r- r z OntotextGraphDBGraph._get_authl si
:>>"4d;;:>>"4d;; *
* 9
))t c v | j d dS # t $ r t d w xY w)zE
Executes a simple `ASK` query to check connectivity
zASK { ?s ?p ?o }zCould not query the provided endpoint. Please, check, if the value of the provided query_endpoint points to the right repository. If GraphDB is secured, please, make sure that the environment variables 'GRAPHDB_USERNAME' and 'GRAPHDB_PASSWORD' are set.N)r# queryr r* s r- r$ z(OntotextGraphDBGraph._check_connectivity~ sW
J / 0 0 0 0 0 E
s 8c r ddl }t j | st d| d t j | t j st d| d |j } | | | n&# t $ r}t d| d | d}~ww xY w|S )
zM
Parse the ontology schema statements from the provided file
r NzFile z does not exist.zRead permission for z is restrictedr zInvalid file format for z : ) r r3 pathexistsFileNotFoundErroraccessR_OKPermissionErrorConjunctiveGraphparse Exceptionr )r r r r# es r- r% z4OntotextGraphDBGraph._load_ontology_schema_from_file s
w~~j)) J#$HJ$H$H$HII IyRW-- U!"S"S"S"STT T'')) L KK
+ AAAr: c ddl m} | j | }n # |$ r}t d| d}~ww xY w|j S )zQ
Execute the query for collecting the ontology schema statements
r ) ParserErrorz&Generated SPARQL statement is invalid
N)rdflib.exceptionsrS r# r: r )r* r: rS resultsrF s r- r' z5OntotextGraphDBGraph._load_ontology_schema_with_query sw 211111 Lj&&u--GG L L L Jq J JKK K L } s # ?:?c | j S )zK
Returns the schema of the graph database in turtle format
)r) r; s r-
get_schemaz OntotextGraphDBGraph.get_schema s
{r8 List[rdflib.query.ResultRow]c ` ddl m | j | }fd|D S )z"
Query the graph.
r ) ResultRowc 4 g | ]}t | |S )rM ).0rrZ s r-
z.OntotextGraphDBGraph.query.. s( ;;;a*Q ":":;;;;r8 ) rdflib.queryrZ r# r: )r* r: resrZ s @r- r: zOntotextGraphDBGraph.query sF +*****j u%%;;;;3;;;;r8 )NNN)
r
r r r
r r
r r
r r )r r/ )r r )N)r r r r )r r r r )r: r )r r )r: r r rX )__name__
__module__ __qualname____doc__r. staticmethodr r$ r% r& r' propertyrW r: r\ r8 r- r r s " )-$(+/ LG LG LG LG LG\ \" \" \& X
<
<
<
<
<
rj s " " " " " " MMMC< C< C< C< C< C< C< C< C< C