https://github.com/grantstreetgroup/dbix-parseerror-mysql

Error parser for MySQL
https://github.com/grantstreetgroup/dbix-parseerror-mysql

Last synced: about 1 month ago
JSON representation

Error parser for MySQL

• Host: GitHub
• URL: https://github.com/grantstreetgroup/dbix-parseerror-mysql
• Owner: GrantStreetGroup
• License: other
• Created: 2021-02-11T21:56:51.000Z (almost 4 years ago)
• Default Branch: master
• Last Pushed: 2024-11-19T18:54:55.000Z (about 2 months ago)
• Last Synced: 2024-11-19T19:53:35.812Z (about 2 months ago)
• Language: Perl
• Size: 20.5 KB
• Stars: 0
• Watchers: 7
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# NAME

DBIx::ParseError::MySQL - Error parser for MySQL

# VERSION

version v1.0.3

# SYNOPSIS

    use DBIx::ParseError::MySQL;

    eval {

        my $result = $dbh->do('SELECT 1');

    };

    if ($@) {

        if (DBIx::ParseError::MySQL->new($@)->is_transient) { $dbh->reconnect }

        else                                                { die; }

    }

# DESCRIPTION

This module is a database error categorizer, specifically for MySQL. This module is also

compatible with Galera's WSREP errors.

# ATTRIBUTES

## orig\_error

Returns the original, untouched error object or string.

## error\_string

Returns the stringified version of the error.

## error\_type

Returns a string that describes the type of error.  These can be one of the following:

    lock             Lock errors, like a lock wait timeout or deadlock

    connection       Connection/packet failures, disconnections

    shutdown         Errors that happen when a server is shutting down

    duplicate_value  Duplicate entry errors

    unknown          Any other error

## is\_transient

Returns a true value if the error is the type that is likely transient.  For example,

errors that recommend retrying transactions or connection failures.  This check can be

used to figure out if it's worth retrying a transaction.

This is merely a check for the following [error types](#error_type):

`lock connection shutdown`.

# CONSTRUCTORS

## new

    my $parsed_error = DBIx::ParseError::MySQL->new($@);

Returns a `DBIx::ParseError::MySQL` object.  Since the error is the only parameter, it

can be passed by itself.

# SEE ALSO

[DBIx::Class::ParseError](https://metacpan.org/pod/DBIx%3A%3AClass%3A%3AParseError) - A similar parser, but specifically tailored to [DBIx::Class](https://metacpan.org/pod/DBIx%3A%3AClass).

# AUTHOR

Grant Street Group 

# COPYRIGHT AND LICENSE

This software is Copyright (c) 2020 - 2023 by Grant Street Group.

This is free software, licensed under:

    The Artistic License 2.0 (GPL Compatible)