Python MariaDB ट्यूटोरियल: कनेक्ट, CRUD, लेनदेन, और त्रुटि प्रबंधन

1. परिचय

उन लोगों के लिए जो Python में MariaDB के साथ काम करना चाहते हैं

कई लोग Python का उपयोग करके MariaDB से कनेक्ट होना और डेटा को हेरफेर करना चाहते हैं। इस लेख में हम MariaDB को Python के साथ उपयोग करने के बुनियादी से लेकर उन्नत विषयों तक सब कुछ समझाएंगे।

क्या आपको इन समस्याओं में से कोई है?

• आपको नहीं पता कि Python से MariaDB कैसे कनेक्ट करें
• आप Python का उपयोग करके MariaDB में डेटा को आसानी से बनाना, पढ़ना, अपडेट करना और हटाना चाहते हैं
• आप सामान्य त्रुटियों और उन्हें कैसे ठीक करें, सीखना चाहते हैं

इस लेख में आप क्या सीखेंगे

• Python से MariaDB को आसानी से कनेक्ट करने का तरीका
• CRUD (Create, Read, Update, Delete) को लागू करना
• सामान्य त्रुटियाँ और उनके समाधान
• लेनदेन (transactions) के साथ डेटा की अखंडता कैसे सुरक्षित रखें

इस लेख को पढ़ने के बाद आप Python के साथ MariaDB को सहजता से उपयोग कर पाएँगे। अब, चलिए विवरण में उतरते हैं।

2. पर्यावरण सेटअप (MariaDB और Python की स्थापना)

MariaDB क्या है?

MariaDB एक ओपन-सोर्स रिलेशनल डेटाबेस मैनेजमेंट सिस्टम (RDBMS) है जो MySQL के उत्तराधिकारी के रूप में व्यापक रूप से उपयोग किया जाता है। MySQL के साथ उच्च संगतता बनाए रखते हुए, MariaDB ने प्रदर्शन में सुधार किया है और नई सुविधाएँ जोड़ी हैं।

आवश्यक उपकरण

Python में MariaDB के साथ काम करने के लिए आपको निम्नलिखित उपकरण तैयार करने होंगे:

• Python (संस्करण 3.x या बाद का अनुशंसित)
• MariaDB (सर्वर)
• MariaDB Python कनेक्टर (mariadb लाइब्रेरी)

MariaDB कैसे स्थापित करें (ऑपरेटिंग सिस्टम के अनुसार)

Windows के लिए

1. आधिकारिक वेबसाइट से MariaDB इंस्टॉलर डाउनलोड करें।
2. इंस्टॉलर चलाएँ और स्थापना पूर्ण करने के लिए निर्देशों का पालन करें।
3. स्थापना के बाद, नीचे दिया गया कमांड चलाकर जाँचें कि MariaDB काम कर रहा है:

   mysql -u root -p
   

4. यदि आप सफलतापूर्वक लॉग इन कर सकते हैं, तो स्थापना पूर्ण हो गई है।

Mac के लिए

Mac पर आप Homebrew का उपयोग करके आसानी से MariaDB स्थापित कर सकते हैं।

1. यदि Homebrew स्थापित नहीं है, तो नीचे दिए कमांड से इसे स्थापित करें:

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   

2. MariaDB स्थापित करें:

   brew install mariadb
   

3. MariaDB शुरू करें:

   brew services start mariadb
   

4. स्थापना की पुष्टि करें:

   mysql -u root -p
   

Linux (Ubuntu) के लिए

1. पैकेज सूची को अपडेट करें और MariaDB स्थापित करें:

   sudo apt update
   sudo apt install mariadb-server mariadb-client
   

2. MariaDB शुरू करें:

   sudo systemctl start mariadb
   

3. MariaDB को सक्षम करें (बूट पर स्वचालित रूप से शुरू हो):

   sudo systemctl enable mariadb
   

4. सुरक्षित स्थापना स्क्रिप्ट चलाएँ:

   sudo mysql_secure_installation
   

यह आपको रूट पासवर्ड सेट करने और अनावश्यक डिफ़ॉल्ट सेटिंग्स को हटाने की अनुमति देता है।

Python और आवश्यक लाइब्रेरी की स्थापना

MariaDB को Python के साथ एकीकृत करने के लिए आपको mariadb लाइब्रेरी स्थापित करनी होगी।

1. pip का उपयोग करके mariadb लाइब्रेरी स्थापित करें :

   pip install mariadb
   

2. स्थापना की पुष्टि करें:

   import mariadb
   print("The MariaDB library was installed successfully.")
   

यदि कोई त्रुटि नहीं आती, तो स्थापना सफल रही।

अब आपका Python के साथ MariaDB उपयोग करने के लिए पर्यावरण सेटअप पूर्ण हो गया है। अगले भाग में हम Python से MariaDB को कनेक्ट करने की विधि समझाएंगे।

3. MariaDB से कनेक्ट करना

Python के साथ MariaDB से कैसे कनेक्ट करें

आवश्यक लाइब्रेरी आयात करें

MariaDB से कनेक्ट होने के लिए Python की mariadb लाइब्रेरी आयात करें।

import mariadb

डेटाबेस से कनेक्ट करने का मूल कोड

नीचे दिया गया कोड Python का उपयोग करके MariaDB से कनेक्ट होने का मूल तरीका दर्शाता है।

import mariadb

# Database connection settings
config = {
    "host": "localhost",   # Hostname of the MariaDB server
    "user": "root",        # MariaDB username
    "password": "password", # MariaDB password
    "database": "sample_db" # Database name to connect to
}

try:
    # Connect to MariaDB
    conn = mariadb.connect(**config)
    print("Connected to MariaDB!")

    # Create a cursor
    cursor = conn.cursor()

    # If the connection succeeds, close it
    cursor.close()
    conn.close()
except mariadb.Error as e:
    print(f"Connection error: {e}")

About the arguments of connect()

If the server is remote, specify an IP address or domain name in host.

A secure connection method using environment variables

Hardcoding sensitive information such as passwords directly in your code is a security risk. By using environment variables, you can manage them more safely.

Install python-dotenv

First, install a library to manage environment variables.

pip install python-dotenv

Create a .env file and write your connection settings

Create a .env file in your project folder and add your connection settings like this:

DB_HOST=localhost
DB_USER=root
DB_PASSWORD=password
DB_NAME=sample_db

Load environment variables in your Python script

To load the .env file in a Python script, write the following:

import mariadb
import os
from dotenv import load_dotenv

# Load the .env file
load_dotenv()

config = {
    "host": os.getenv("DB_HOST"),
    "user": os.getenv("DB_USER"),
    "password": os.getenv("DB_PASSWORD"),
    "database": os.getenv("DB_NAME")
}

try:
    conn = mariadb.connect(**config)
    print("Connected securely to MariaDB!")
    conn.close()
except mariadb.Error as e:
    print(f"Connection error: {e}")

Common connection errors and how to fix them

Below are some errors you may encounter when connecting Python to MariaDB, along with their solutions.

Access denied for user 'root'@'localhost'

Error message

mariadb.OperationalError: Access denied for user 'root'@'localhost' (using password: YES)

Causes

• The user’s credentials are incorrect
• MariaDB authentication settings are not configured properly

Solutions

1. Log in to MariaDB and check the user’s privileges.

   mysql -u root -p
   

2. Grant the required privileges to the user.

   GRANT ALL PRIVILEGES ON *.* TO 'root'@'localhost' IDENTIFIED BY 'password' WITH GRANT OPTION;
   FLUSH PRIVILEGES;
   

3. Try connecting again.

Can't connect to MySQL server on 'localhost'

Error message

mariadb.OperationalError: Can't connect to MySQL server on 'localhost' (10061)

Causes

• The MariaDB server is not running
• The host setting is incorrect

Solutions

1. Check whether the server is running.

   sudo systemctl status mariadb
   

2. If the server is stopped, start it.

   sudo systemctl start mariadb
   

3. Check that the host setting is correct.

Summary

In this section, we explained how to connect to MariaDB from Python.

• Basic connection method using mariadb.connect()
• A secure connection method using a .env file
• Common connection errors and how to fix them

4. Creating Databases and Tables

Creating a database

In MariaDB, you need to create a database to store data. Let’s look at how to create a database using Python.

Create a database using a MariaDB management tool

You can create a database using the MariaDB command line (or GUI tools such as MySQL Workbench).

CREATE DATABASE sample_db;

To view the list of databases you created, use the following command:

SHOW DATABASES;

Create a database using Python

To create a database using Python, run the following code:

import mariadb

# Database connection (no database specified)
config = {
    "host": "localhost",
    "user": "root",
    "password": "password"
}

try:
    conn = mariadb.connect(**config)
    cursor = conn.cursor()

    # Create the database
    cursor.execute("CREATE DATABASE IF NOT EXISTS sample_db")

    print("Created database 'sample_db'.")

    cursor.close()
    conn.close()
except mariadb.Error as e:
    print(f"Error occurred: {e}")

By adding IF NOT EXISTS, you can prevent errors if a database with the same name already exists.

Creating a table

After creating the database, the next step is to create a table to store data.

Basic table structure

A table typically has a structure like the following:

Create a table with SQL

If you create a table using MariaDB SQL commands, write the following:

USE sample_db;

CREATE TABLE users (
    id INT AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(100) NOT NULL,
    email VARCHAR(100) UNIQUE NOT NULL,
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP
);

To view the list of tables, run:

SHOW TABLES;

Create a table using Python

Here is how to create the same table using a Python script.

import mariadb

# Database connection
config = {
    "host": "localhost",
    "user": "root",
    "password": "password",
    "database": "sample_db"
}

try:
    conn = mariadb.connect(**config)
    cursor = conn.cursor()

    # Table creation SQL
    table_creation_query = """
    CREATE TABLE IF NOT EXISTS users (
        id INT AUTO_INCREMENT PRIMARY KEY,
        name VARCHAR(100) NOT NULL,
        email VARCHAR(100) UNIQUE NOT NULL,
        created_at DATETIME DEFAULT CURRENT_TIMESTAMP
    )
    """

    cursor.execute(table_creation_query)
    print("Created table 'users'.")

    cursor.close()
    conn.close()
except mariadb.Error as e:
    print(f"Error occurred: {e}")

By adding IF NOT EXISTS, you can prevent errors if the table already exists.

How to choose data types

When designing tables, it is important to choose appropriate data types. Below is a summary of commonly used data types in MariaDB.

For example, it is common to use VARCHAR(100) for the name field, but if you need a longer string, TEXT can be a good option.

How to check and drop existing tables

Check existing tables

To check the tables in a database, use the following SQL:

SHOW TABLES;

To view a table’s detailed structure, run the DESCRIBE command:

DESCRIBE users;

Drop a table

To drop a table, use DROP TABLE:

DROP TABLE users;

To drop a table from Python, run the following code:

cursor.execute("DROP TABLE IF EXISTS users")

Summary

In this section, we explained how to create databases and tables in MariaDB to store data.

• How to create a database in MariaDB
• How to create a table using Python
• How to choose appropriate data types
• How to check and drop existing tables

Now the basic setup for MariaDB is complete. In the next section, we will explain CRUD operations (Create, Read, Update, Delete) in detail.

5. CRUD Operations (Create, Read, Update, Delete)

After creating the MariaDB database and tables, the next step is to perform CRUD operations. CRUD stands for Create, Read, Update, and Delete, which are the basic operations of a database.

In this section, we will explain how to manipulate MariaDB data using Python.

Inserting data (INSERT)

To add a new record to the database, use the INSERT statement.

Insert data using SQL

To insert data using MariaDB SQL, execute the following command:

INSERT INTO users (name, email) VALUES ('Alice', 'alice@example.com');

To verify the inserted data, use the SELECT statement:

SELECT * FROM users;

Insert data using Python

To insert data using Python, run the following code:

import mariadb

# Database connection settings
config = {
    "host": "localhost",
    "user": "root",
    "password": "password",
    "database": "sample_db"
}

try:
    conn = mariadb.connect(**config)
    cursor = conn.cursor()

    # Insert data
    insert_query = "INSERT INTO users (name, email) VALUES (?, ?)"
    data = ("Alice", "alice@example.com")
    cursor.execute(insert_query, data)

    # Save changes
    conn.commit()
    print("Data inserted successfully!")

    cursor.close()
    conn.close()
except mariadb.Error as e:
    print(f"Error occurred: {e}")

Key points:

• Using ? placeholders helps prevent SQL injection.
• If you do not execute conn.commit() , the data will not be saved to the database.

Retrieving data (SELECT)

To retrieve registered data, use the SELECT statement.

Retrieve data using SQL

To retrieve data using MariaDB SQL:

SELECT * FROM users;

To retrieve data with conditions, use the WHERE clause:

SELECT * FROM users WHERE email = 'alice@example.com';

Retrieve data using Python

To retrieve data using Python, run the following code:

import mariadb

config = {
    "host": "localhost",
    "user": "root",
    "password": "password",
    "database": "sample_db"
}

try:
    conn = mariadb.connect(**config)
    cursor = conn.cursor()

    # Retrieve data
    select_query = "SELECT id, name, email FROM users"
    cursor.execute(select_query)

    # Display retrieved data
    for (id, name, email) in cursor:
        print(f"ID: {id}, Name: {name}, Email: {email}")

    cursor.close()
    conn.close()
except mariadb.Error as e:
    print(f"Error occurred: {e}")

Key points:

• Execute SQL with cursor.execute(select_query) and retrieve data from the cursor object.
• You can process records one by one using a for loop.

Updating data (UPDATE)

To modify registered data, use the UPDATE statement.

Update data using SQL

To update data using MariaDB SQL, execute:

UPDATE users SET name = 'Alice Smith' WHERE email = 'alice@example.com';

Update data using Python

To update data using Python, run the following code:

import mariadb

config = {
    "host": "localhost",
    "user": "root",
    "password": "password",
    "database": "sample_db"
}

try:
    conn = mariadb.connect(**config)
    cursor = conn.cursor()

    # Update data
    update_query = "UPDATE users SET name = ? WHERE email = ?"
    data = ("Alice Smith", "alice@example.com")
    cursor.execute(update_query, data)

    # Save changes
    conn.commit()
    print("Data updated successfully!")

    cursor.close()
    conn.close()
except mariadb.Error as e:
    print(f"Error occurred: {e}")

Deleting data (DELETE)

To remove unnecessary data, use the DELETE statement.

Delete data using SQL

To delete data using MariaDB SQL, execute:

DELETE FROM users WHERE email = 'alice@example.com';

Delete data using Python

To delete data using Python, run the following code:

import mariadb

config = {
    "host": "localhost",
    "user": "root",
    "password": "password",
    "database": "sample_db"
}

try:
    conn = mariadb.connect(**config)
    cursor = conn.cursor()

    # Delete data
    delete_query = "DELETE FROM users WHERE email = ?"
    data = ("alice@example.com",)
    cursor.execute(delete_query, data)

    # Save changes
    conn.commit()
    print("Data deleted successfully!")

    cursor.close()
    conn.close()
except mariadb.Error as e:
    print(f"Error occurred: {e}")

Summary

In this section, we explained how to manipulate MariaDB data using Python.

• Insert data (INSERT)
• Retrieve data (SELECT)
• Update data (UPDATE)
• Delete data (DELETE)

You can now perform basic data operations in MariaDB using Python.

6. Transactions and Rollback (Ensuring Data Integrity)

जब डेटाबेस के साथ काम किया जाता है, तो ट्रांज़ैक्शन का उपयोग करके डेटा की अखंडता बनाए रखना महत्वपूर्ण होता है।
विशेष रूप से, प्रसंस्करण के दौरान त्रुटि होने पर डेटा को उसके मूल स्थिति में पुनर्स्थापित करने (रोलबैक) की क्षमता निरंतरता बनाए रखने के लिए आवश्यक है।

इस अनुभाग में, हम Python का उपयोग करके MariaDB में ट्रांज़ैक्शन को कैसे प्रबंधित किया जाए, यह समझाएंगे।

ट्रांज़ैक्शन क्या है?

एक ट्रांज़ैक्शन वह तंत्र है जो डेटाबेस संचालन की एक श्रृंखला को एक इकाई में समूहित करता है, सभी प्रक्रियाओं के सफल होने पर सभी परिवर्तन कमिट करता है, और त्रुटि होने पर सभी परिवर्तन रोलबैक करता है।

ट्रांज़ैक्शन की विशेषताएँ

• ACID गुण
• एटॉमिकिटी : सभी संचालन या तो सफलतापूर्वक पूर्ण होते हैं या कोई भी लागू नहीं होता।
• कंसिस्टेंसी : डेटा की अखंडता बनी रहती है।
• आइसोलेशन : समानांतर ट्रांज़ैक्शन एक-दूसरे में हस्तक्षेप नहीं करते।
• ड्यूराबिलिटी : एक बार कमिट हो जाने पर, परिवर्तन स्थायी रूप से सहेजे जाते हैं।

बुनियादी ट्रांज़ैक्शन संचालन (COMMIT और ROLLBACK)

MariaDB ट्रांज़ैक्शन को निम्नलिखित कमांडों के साथ नियंत्रित किया जा सकता है:

Python में ट्रांज़ैक्शन का उपयोग

नीचे Python का उपयोग करके MariaDB ट्रांज़ैक्शन को प्रबंधित करने का एक बुनियादी उदाहरण दिया गया है।

एक ही ट्रांज़ैक्शन में कई संचालन का प्रबंधन

निम्नलिखित कोड कई इन्सर्ट संचालन को एक ट्रांज़ैक्शन के रूप में लेता है और केवल तभी कमिट करता है जब सभी संचालन सफल हों।

import mariadb

config = {
    "host": "localhost",
    "user": "root",
    "password": "password",
    "database": "sample_db"
}

try:
    conn = mariadb.connect(**config)
    cursor = conn.cursor()

    # Start transaction
    conn.start_transaction()

    # Insert data
    cursor.execute("INSERT INTO users (name, email) VALUES (?, ?)", ("Bob", "bob@example.com"))
    cursor.execute("INSERT INTO users (name, email) VALUES (?, ?)", ("Charlie", "charlie@example.com"))

    # Commit if all operations succeed
    conn.commit()
    print("Data added successfully.")

    cursor.close()
    conn.close()
except mariadb.Error as e:
    print(f"Error occurred: {e}")
    conn.rollback()  # Roll back if an error occurs

मुख्य बिंदु

• ट्रांज़ैक्शन शुरू करने के लिए conn.start_transaction() का उपयोग करें।
• परिवर्तन को अंतिम रूप देने के लिए conn.commit() का उपयोग करें (कमिट के बाद इसे वापस नहीं किया जा सकता)।
• यदि कोई त्रुटि आती है, तो परिवर्तन रद्द करने और मूल स्थिति को पुनर्स्थापित करने के लिए conn.rollback() का उपयोग करें।

ट्रांज़ैक्शन-आधारित त्रुटि प्रबंधन

डेटाबेस संचालन के दौरान त्रुटियाँ हो सकती हैं।
उदाहरण के लिए, डुप्लिकेट ईमेल पता (UNIQUE प्रतिबंध उल्लंघन) या सर्वर टाइमआउट हो सकता है।

त्रुटि प्रबंधन के साथ ट्रांज़ैक्शन प्रबंधन

निम्नलिखित कोड प्रसंस्करण के दौरान त्रुटि होने पर परिवर्तन रोलबैक करने और मूल स्थिति को पुनर्स्थापित करने की लॉजिक जोड़ता है।

import mariadb

config = {
    "host": "localhost",
    "user": "root",
    "password": "password",
    "database": "sample_db"
}

try:
    conn = mariadb.connect(**config)
    cursor = conn.cursor()

    # Start transaction
    conn.start_transaction()

    try:
        # First insert succeeds
        cursor.execute("INSERT INTO users (name, email) VALUES (?, ?)", ("Dave", "dave@example.com"))

        # Second insert causes an error (duplicate email)
        cursor.execute("INSERT INTO users (name, email) VALUES (?, ?)", ("Eve", "dave@example.com"))

        # Commit if all operations succeed
        conn.commit()
        print("Data inserted successfully.")

    except mariadb.Error as e:
        print(f"Error occurred during data processing: {e}")
        conn.rollback()  # Roll back on error
        print("Transaction rolled back.")

    cursor.close()
    conn.close()

except mariadb.Error as e:
    print(f"Database connection error: {e}")

सारांश

इस अनुभाग में, हमने ट्रांज़ैक्शन की मूल बातें और उन्हें Python में कैसे लागू किया जाए समझाया।

• ट्रांज़ैक्शन और ACID गुणों का महत्व
• Python में commit() और rollback() का उपयोग कैसे करें
• त्रुटि प्रबंधन के साथ ट्रांज़ैक्शन प्रबंधन

7. त्रुटि संभाल (सामान्य त्रुटियां और समाधान)

जब आप Python में MariaDB के साथ काम करते हैं, तो त्रुटियां हो सकती हैं।
विशेष रूप से, डेटाबेस कनेक्शन त्रुटियां, SQL सिंटैक्स त्रुटियां, और डेटा इंटेग्रिटी त्रुटियां सामान्य हैं, इसलिए उनके कारणों और समाधान को समझना महत्वपूर्ण है।

इस अनुभाग में, हम सामान्य त्रुटियों के कारण और उन्हें कैसे ठीक करें प्रस्तुत करते हैं।

Access denied for user (प्रमाणीकरण त्रुटि)

त्रुटि संदेश

mariadb.OperationalError: Access denied for user 'root'@'localhost' (using password: YES)

कारण

• उपयोगकर्ता नाम या पासवर्ड गलत है
• MariaDB उपयोगकर्ता के पास उपयुक्त विशेषाधिकार नहीं हैं

समाधान

1. MariaDB में लॉग इन करें और उपयोगकर्ता विशेषाधिकार जांचें

   mysql -u root -p
   

2. उपयोगकर्ता को विशेषाधिकार प्रदान करें

   GRANT ALL PRIVILEGES ON *.* TO 'root'@'localhost' IDENTIFIED BY 'password' WITH GRANT OPTION;
   FLUSH PRIVILEGES;
   

3. MariaDB को पुनः आरंभ करें

   sudo systemctl restart mariadb
   

Can't connect to MySQL server on 'localhost' (कनेक्शन त्रुटि)

त्रुटि संदेश

mariadb.OperationalError: Can't connect to MySQL server on 'localhost' (10061)

कारण

• MariaDB सर्वर चल नहीं रहा है
• host सेटिंग गलत है

समाधान

1. जाँचें कि MariaDB सर्वर चल रहा है या नहीं

   sudo systemctl status mariadb
   

2. यदि सर्वर बंद है, तो इसे शुरू करें

   sudo systemctl start mariadb
   

3. सर्वर को स्वचालित रूप से शुरू होने के लिए सक्षम करें

   sudo systemctl enable mariadb
   

Unknown database 'sample_db' (डेटाबेस मौजूद नहीं है)

त्रुटि संदेश

mariadb.ProgrammingError: Unknown database 'sample_db'

कारण

• निर्दिष्ट डेटाबेस मौजूद नहीं है
• डेटाबेस नाम में टाइपो है

समाधान

1. डेटाबेस की सूची जांचें

   SHOW DATABASES;
   

2. यदि डेटाबेस मौजूद नहीं है तो उसे बनाएं

   CREATE DATABASE sample_db;
   

Table doesn't exist (टेबल मौजूद नहीं है)

त्रुटि संदेश

mariadb.ProgrammingError: Table 'sample_db.users' doesn't exist

कारण

• निर्दिष्ट टेबल मौजूद नहीं है
• USE sample_db; का उपयोग करके डेटाबेस चयनित नहीं किया गया था

समाधान

1. टेबल की सूची जांचें

   SHOW TABLES;
   

2. यदि टेबल मौजूद नहीं है तो उसे बनाएं

   CREATE TABLE users (
       id INT AUTO_INCREMENT PRIMARY KEY,
       name VARCHAR(100) NOT NULL,
       email VARCHAR(100) UNIQUE NOT NULL,
       created_at DATETIME DEFAULT CURRENT_TIMESTAMP
   );
   

Duplicate entry (डुप्लिकेट डेटा त्रुटि)

त्रुटि संदेश

mariadb.IntegrityError: Duplicate entry 'alice@example.com' for key 'users.email'

कारण

• email कॉलम पर UNIQUE प्रतिबंध है, इसलिए डुप्लिकेट मान नहीं डाले जा सकते

समाधान

• डेटा डालने से पहले डुप्लिकेट की जाँच करें
• ON DUPLICATE KEY UPDATE का उपयोग करें

डुप्लिकेट रोकने के लिए Python कोड

try:
    cursor.execute("INSERT INTO users (name, email) VALUES (?, ?)", ("Alice", "alice@example.com"))
    conn.commit()
except mariadb.IntegrityError:
    print("Error: The email address already exists.")

या ON DUPLICATE KEY UPDATE का उपयोग करें

INSERT INTO users (name, email) VALUES ('Alice', 'alice@example.com')
ON DUPLICATE KEY UPDATE name = 'Alice Updated';

Incorrect number of bindings (पैरामीटर गिनती असंगतता)

त्रुटि संदेश

mariadb.ProgrammingError: Incorrect number of bindings supplied. The current statement uses 2, and there are 1 supplied.

कारण

• SQL कथन द्वारा आवश्यक पैरामीटरों की संख्या प्रदान किए गए तर्कों की संख्या से मेल नहीं खाती

समाधान

• सुनिश्चित करें कि प्लेसहोल्डर की संख्या पैरामीटरों की संख्या से मेल खाती है

गलत कोड

cursor.execute("INSERT INTO users (name, email) VALUES (?, ?)", ("Alice"))

सही कोड

cursor.execute("INSERT INTO users (name, email) VALUES (?, ?)", ("Alice", "alice@example.com"))

सारांश

इस अनुभाग में, हमने Python में MariaDB के साथ काम करते समय होने वाली सामान्य त्रुटियों और उन्हें कैसे हल किया जाए, समझाया।

• Access denied for user (प्रमाणीकरण त्रुटि)
• Can't connect to MySQL server (कनेक्शन त्रुटि)
• Unknown database (डेटाबेस मौजूद नहीं है)
• Table doesn't exist (टेबल मौजूद नहीं है)
• Duplicate entry (डुप्लिकेट डेटा त्रुटि)
• Incorrect number of bindings (पैरामीटर गिनती में असंगति)

8. निष्कर्ष

इस लेख में, हमने Python के साथ MariaDB का उपयोग कैसे करें को बुनियादी अवधारणाओं से लेकर अधिक उन्नत विषयों तक समझाया।
डेटाबेस के मूलभूत संचालन को समझकर और त्रुटि प्रबंधन तथा लेनदेन प्रबंधन को सही ढंग से लागू करके, आप अधिक सुरक्षित और कुशल डेटा संचालन कर सकते हैं।

लेख का पुनरावलोकन

पर्यावरण सेटअप

• MariaDB कैसे स्थापित करें (Windows / Mac / Linux)
• Python के लिए MariaDB कनेक्टर लाइब्रेरी (mariadb) कैसे स्थापित करें

MariaDB से कनेक्ट करना

• बेसिक डेटाबेस कनेक्शन विधियाँ
• पर्यावरण वेरिएबल्स का उपयोग करके सुरक्षित कनेक्शन
• सामान्य कनेक्शन त्रुटियों के समाधान

डेटाबेस और टेबल बनाना

• डेटाबेस बनाना (SQL / Python)
• टेबल बनाना और डेटा प्रकार चुनना
• मौजूदा टेबल की जाँच और हटाना

CRUD संचालन (Create, Read, Update, Delete)

• Python का उपयोग करके बुनियादी डेटा संचालन
• SQL इंजेक्शन रोकने के लिए प्लेसहोल्डर का उपयोग
• उचित त्रुटि प्रबंधन

लेनदेन और रोलबैक

• लेनदेन का महत्व (ACID गुण)
• त्रुटि पर डेटा पुनर्स्थापित करना (रोलबैक)
• AutoCommit को निष्क्रिय करके लेनदेन को मैन्युअल रूप से प्रबंधित करना

त्रुटि प्रबंधन (सामान्य त्रुटियाँ और समाधान)

• प्रमाणीकरण त्रुटियाँ (Access denied for user)
• कनेक्शन त्रुटियाँ (Can't connect to MySQL server)
• डेटाबेस या टेबल न मिलने की त्रुटियाँ
• डुप्लिकेट डेटा त्रुटियाँ (Duplicate entry)
• डेडलॉक्स को संभालना और रीट्राई लॉजिक लागू करना

Python और MariaDB को मिलाते समय मुख्य बिंदु

1. प्लेसहोल्डर का उपयोग करें

   cursor.execute("INSERT INTO users (name, email) VALUES (?, ?)", ("Alice", "alice@example.com"))
   

→ SQL कथनों में सीधे एम्बेड करने के बजाय बाइंड वेरिएबल्स का उपयोग करें ताकि SQL इंजेक्शन रोका जा सके।

2. लेनदेन को सही ढंग से प्रबंधित करें

• conn.commit() का उपयोग करके स्पष्ट रूप से परिवर्तन कमिट करें।
• त्रुटि पर conn.rollback() का उपयोग करके डेटा की अखंडता बनाए रखें।

3. व्यापक त्रुटि प्रबंधन लागू करें

• संभावित त्रुटियों को पहले से पकड़ने के लिए try-except ब्लॉक्स का उपयोग करें।
• OperationalError और IntegrityError जैसी त्रुटियों के लिए विशिष्ट हैंडलिंग रणनीतियाँ तैयार करें।

4. प्रदर्शन पर विचार करें

• बुल्क इन्सर्ट्स (एक साथ कई रिकॉर्ड डालना)
• उचित इंडेक्सिंग (खोज प्रदर्शन में सुधार)

आगे सीखने के संसाधन

यदि आप Python और MariaDB को एकीकृत करने की अपनी समझ को गहरा करना चाहते हैं, तो निम्नलिखित संसाधनों पर विचार करें:

आधिकारिक दस्तावेज़

• MariaDB Official Documentation

संबंधित शिक्षण सामग्री

• SQL Basics (W3Schools)
• Database Operations with Python (Real Python)

सिफारिशी पुस्तकें

• SQL, 2nd Edition: Database Operations from Scratch – SQL मूलभूत सिद्धांतों को पूरी तरह से सीखें
• Effective Python: 90 Specific Ways to Improve Your Python Programs – Python सर्वोत्तम प्रथाओं को सीखें

सारांश

MariaDB को Python के साथ एकीकृत करके, आप स्क्रिप्ट-आधारित डेटा प्रबंधन और स्वचालन सक्षम कर सकते हैं।
केवल बुनियादी CRUD संचालन ही नहीं, बल्कि उचित त्रुटि प्रबंधन और लेनदेन प्रबंधन को लागू करके, आप एक सुरक्षित और अधिक कुशल प्रणाली बना सकते हैं।

अगले चरण के रूप में, अपने ज्ञान को व्यावहारिक डेटाबेस संचालन में लागू करने के लिए प्रभावी डेटा प्रबंधन और API एकीकरण के बारे में सीखने पर विचार करें।