Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 21 additions & 0 deletions docs/user_guide/troubleshooting.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,27 @@

Use this page to map symptoms to status checks and recovery actions.

## Function Does Not Exist (Type Cast Error)

Symptom:

```text
ERROR: function graph.add_table(unknown, unknown) does not exist
HINT: No function matches the given name and argument types. You might need to add explicit type casts.
```

Check:

Are you passing a table name as a plain string, such as `'public.users'`?

Fix:

pgGraph's table registration functions require PostgreSQL Object Identifiers (OIDs), not plain text strings. Add the `::regclass` cast to the table name argument:

```sql
SELECT graph.add_table('public.users'::regclass, 'id');
```

## Graph Not Built

Symptom:
Expand Down