Skip to main content

Troubleshooting Guide: Resolving "AccountsRecTrans Does Not Exist" Error

Distributor troubleshooting for an 'AccountsRecTrans does not exist' database error in Encompass: check table spelling, schema context, recent deployments and case sensitivity. Needs admin access; v26.01+.

B
Written by Bailey Naas-Thornton

Minimum Version Required: 26.01

Pre-Conditions

  • Requires database administrator or developer access to review application query logic and schema configurations.

  • Must have access to verify deployment logs and recent migration or hotfix scripts.

  • Requires access to the target operating system or server configuration settings.

Steps

  • Verify Query Spelling: Review the application query logic for any typographical errors in the table name (e.g., ensure it is spelled exactly as AccountsRecTrans).

  • Verify Table Instantiation: Check the current environment to confirm whether the table has been created and properly instantiated.

  • Verify Target Schema: Review the database connection and query context to ensure the correct target database schema or catalog context is selected.

  • Review Recent Deployments: Check if recent migration, hotfix, or deployment scripts were successfully applied to the instance, as missing scripts can cause schema synchronization issues.

  • Check Server Configuration: Verify the case-sensitivity configuration on the target operating system or server to ensure there is no mismatch causing the table name to be unrecognized.

  • Contact Support: If the issue persists, please contact support and provide the following information for efficient troubleshooting:

    • Exact error messages or codes encountered.

    • Screenshots or video recordings of the issue.

    • Log files (specifically application, deployment, or system logs from the time of the error).

    • The exact steps taken by the customer that led to the issue.

    • The date and time the issue was first observed and any recurrence.

    • Any changes made to the system before the issue appeared.

Fields And Definitions

  • AccountsRecTrans: The database table that the system is failing to locate.

  • Schema Out-of-Sync: A condition where the expected database structure does not match the actual database schema in the current environment.

  • Catalog Context: The specific database namespace or target environment that the application query is attempting to access.

  • Migration/Hotfix Scripts: Executable files designed to update the database schema, such as creating new tables or modifying existing ones.

Best Practices

  • Standardize Naming Conventions: Always use exact casing for table names in query logic to prevent case-sensitivity mismatch errors across different server operating systems.

  • Verify Deployments: After applying a hotfix or running migration scripts, perform a routine check of the database schema to ensure all expected tables are instantiated before resuming normal operations.

  • Utilize Test Environments: Test new application query logic and schema changes in a dedicated test database to catch typographical errors or context mismatches before they affect production.

Did this answer your question?