function get_dbo_texttranslations_by_uid
Retrieves a single dbo_TextTranslations node from a Neo4j graph database by matching its unique identifier (UID).
/tf/active/vicechatdev/neo4j_schema/neo4j_python_snippets.py
1093 - 1100
simple
Purpose
This function queries a Neo4j database to fetch a specific text translation node. It's designed for retrieving translation records stored in a graph database structure, likely part of a larger system managing multilingual content or database object translations. The function returns the first matching node or None if no match is found.
Source Code
def get_dbo_texttranslations_by_uid(uid):
"""Get a dbo_TextTranslations node by its UID"""
query = """
MATCH (n:dbo_TextTranslations {UID: $uid})
RETURN n
"""
result = run_query(query, {"uid": uid})
return result[0] if result else None
Parameters
| Name | Type | Default | Kind |
|---|---|---|---|
uid |
- | - | positional_or_keyword |
Parameter Details
uid: The unique identifier (UID) of the dbo_TextTranslations node to retrieve. Expected to be a string or integer value that uniquely identifies a translation record in the Neo4j database. This value is used in the Cypher query's WHERE clause to match the exact node.
Return Value
Returns a dictionary representing the matched Neo4j node if found, containing all properties of the dbo_TextTranslations node. Returns None if no node with the specified UID exists. The exact structure of the returned dictionary depends on the properties stored in the dbo_TextTranslations nodes in the database.
Dependencies
neo4j
Required Imports
from neo4j import GraphDatabase
Usage Example
# Assuming run_query function is defined and Neo4j is configured
# Example run_query implementation:
def run_query(query, params):
driver = GraphDatabase.driver('bolt://localhost:7687', auth=('neo4j', 'password'))
with driver.session() as session:
result = session.run(query, params)
return [record['n'] for record in result]
driver.close()
# Using the function
translation_uid = '12345'
translation_node = get_dbo_texttranslations_by_uid(translation_uid)
if translation_node:
print(f"Found translation: {translation_node}")
else:
print("Translation not found")
Best Practices
- Ensure the run_query function properly handles database connections and closes them after use to prevent connection leaks
- Consider adding error handling for database connection failures or query execution errors
- Validate the uid parameter before passing it to the query to prevent injection attacks
- Consider adding type hints to the function signature for better code documentation
- The function assumes run_query returns a list; ensure this contract is maintained
- Consider adding logging for debugging purposes, especially when nodes are not found
- For production use, implement proper connection pooling through Neo4j driver configuration
Tags
Similar Components
AI-powered semantic similarity - components with related functionality:
-
function get_dbo_texttranslations_by_id 89.2% similar
-
function get_all_dbo_texttranslations 79.5% similar
-
function get_dbo_tnv_by_uid 74.0% similar
-
function get_dbo_flocktypes_by_uid 72.1% similar
-
function get_dbo_treatments_by_uid 71.6% similar