Python MariaDB টিউটোরিয়াল: সংযোগ, CRUD, লেনদেন, এবং ত্রুটি হ্যান্ডলিং

১. ভূমিকা

যারা পাইথনে মারিয়াডিবি-এর সাথে কাজ করতে চান তাদের জন্য

অনেকে পাইথন ব্যবহার করে মারিয়াডিবি-এর সাথে সংযোগ স্থাপন করতে এবং ডেটা পরিচালনা করতে চান। এই নিবন্ধে, আমরা পাইথন ব্যবহার করে মারিয়াডিবি-এর সাথে কাজ করার জন্য মৌলিক থেকে উন্নত বিষয়গুলি সবকিছু ব্যাখ্যা করব।

আপনার কি এই সমস্যাগুলির কোনোটি আছে?

• আপনি পাইথন থেকে মারিয়াডিবি-এর সাথে কীভাবে সংযোগ স্থাপন করবেন তা জানেন না
• আপনি পাইথন ব্যবহার করে মারিয়াডিবি-তে ডেটা সহজেই তৈরি, পড়া, আপডেট এবং মুছে ফেলতে চান
• আপনি সাধারণ ত্রুটিগুলি এবং সেগুলি কীভাবে ঠিক করবেন তা শিখতে চান

এই নিবন্ধে আপনি কী শিখবেন

• পাইথন থেকে মারিয়াডিবি-এর সাথে সহজেই কীভাবে সংযোগ স্থাপন করবেন
• কীভাবে CRUD (Create, Read, Update, Delete) বাস্তবায়ন করবেন
• সাধারণ ত্রুটি এবং তাদের সমাধান
• ট্রানজেকশনের মাধ্যমে ডেটা অখণ্ডতা কীভাবে সুরক্ষিত করবেন

এই নিবন্ধটি পড়ার পর, আপনি পাইথন ব্যবহার করে মারিয়াডিবি-এর সাথে সহজে কাজ করতে পারবেন। এখন, বিস্তারিত বিষয়ে ডুব দিন।

২. পরিবেশ সেটআপ (মারিয়াডিবি এবং পাইথন ইনস্টল করা)

মারিয়াডিবি কী?

মারিয়াডিবি হলো একটি ওপেন-সোর্স রিলেশনাল ডেটাবেস ম্যানেজমেন্ট সিস্টেম (RDBMS) যা মাইএসকিউএল-এর উত্তরসূরি হিসেবে ব্যাপকভাবে ব্যবহৃত হয়। মাইএসকিউএল-এর সাথে উচ্চ সামঞ্জস্যতা বজায় রেখার পাশাপাশি, মারিয়াডিবি-তে পারফরম্যান্স উন্নত করা হয়েছে এবং নতুন ফিচার যোগ করা হয়েছে।

প্রয়োজনীয় টুলস

পাইথনে মারিয়াডিবি-এর সাথে কাজ করার জন্য, আপনাকে নিম্নলিখিত টুলস প্রস্তুত করতে হবে:

• পাইথন (সংস্করণ ৩.এক্স বা তার পরবর্তী সুপারিশকৃত)
• মারিয়াডিবি (সার্ভার)
• মারিয়াডিবি পাইথন কানেক্টর (mariadb লাইব্রেরি)

মারিয়াডিবি কীভাবে ইনস্টল করবেন (অপারেটিং সিস্টেম অনুসারে)

উইন্ডোজের জন্য

1. অফিসিয়াল ওয়েবসাইট থেকে মারিয়াডিবি ইনস্টলার ডাউনলোড করুন।
2. ইনস্টলার চালান এবং নির্দেশাবলী অনুসরণ করে ইনস্টলেশন সম্পূর্ণ করুন।
3. ইনস্টলেশনের পর, নিম্নলিখিত কমান্ড চালিয়ে যাচাই করুন যে মারিয়াডিবি কাজ করছে কিনা:

   mysql -u root -p
   

4. যদি আপনি সফলভাবে লগইন করতে পারেন, তাহলে ইনস্টলেশন সম্পূর্ণ।

ম্যাকের জন্য

ম্যাকে, আপনি Homebrew ব্যবহার করে সহজেই মারিয়াডিবি ইনস্টল করতে পারেন।

1. যদি Homebrew ইনস্টল না থাকে, তাহলে নিম্নলিখিত কমান্ড দিয়ে ইনস্টল করুন:

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

2. মারিয়াডিবি ইনস্টল করুন:

   brew install mariadb
   

3. মারিয়াডিবি শুরু করুন:

   brew services start mariadb
   

4. ইনস্টলেশন যাচাই করুন:

   mysql -u root -p
   

লিনাক্সের জন্য (উবুন্টু)

1. প্যাকেজ লিস্ট আপডেট করুন এবং মারিয়াডিবি ইনস্টল করুন:

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

2. মারিয়াডিবি শুরু করুন:

   sudo systemctl start mariadb
   

3. মারিয়াডিবি সক্ষম করুন (বুটে স্বয়ংক্রিয়ভাবে শুরু):

   sudo systemctl enable mariadb
   

4. সুরক্ষিত ইনস্টলেশন স্ক্রিপ্ট চালান:

   sudo mysql_secure_installation
   

এটি আপনাকে রুট পাসওয়ার্ড সেট করতে এবং অপ্রয়োজনীয় ডিফল্ট সেটিংস সরাতে সাহায্য করে।

পাইথন এবং প্রয়োজনীয় লাইব্রেরি ইনস্টল করা

মারিয়াডিবি-কে পাইথনের সাথে একীভূত করার জন্য, আপনাকে mariadb লাইব্রেরি ইনস্টল করতে হবে।

1. pip ব্যবহার করে mariadb লাইব্রেরি ইনস্টল করুন:

   pip install mariadb
   

2. ইনস্টলেশন যাচাই করুন:

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

যদি কোনো ত্রুটি না ঘটে, তাহলে ইনস্টলেশন সফল।

এখন আপনার পাইথনের সাথে মারিয়াডিবি ব্যবহারের জন্য পরিবেশ সেটআপ সম্পূর্ণ। পরবর্তীতে, আমরা ব্যাখ্যা করব কীভাবে পাইথন থেকে মারিয়াডিবি-এর সাথে সংযোগ স্থাপন করবেন।

৩. মারিয়াডিবি-এর সাথে সংযোগ

পাইথন দিয়ে মারিয়াডিবি-এর সাথে কীভাবে সংযোগ স্থাপন করবেন

প্রয়োজনীয় লাইব্রেরি আমদানি করুন

মারিয়াডিবি-এর সাথে সংযোগ স্থাপন করার জন্য, পাইথনের mariadb লাইব্রেরি আমদানি করুন।

import 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)

ডাটাবেসের সঙ্গে কাজ করার সময়, ট্রানজ্যাকশন ব্যবহার করা গুরুত্বপূর্ণ যাতে ডেটা অখণ্ডতা বজায় থাকে। বিশেষ করে, প্রক্রিয়াকরণের সময় কোনো ত্রুটি ঘটলে ডেটা তার মূল অবস্থায় পুনরুদ্ধার (রোলব্যাক) করার ক্ষমতা সামঞ্জস্য বজায় রাখার জন্য অপরিহার্য।

এই বিভাগে, আমরা মেরিয়াডিবি-তে পাইথন ব্যবহার করে ট্রানজ্যাকশন কীভাবে পরিচালনা করা যায় তা ব্যাখ্যা করব।

What is a transaction?

একটি ট্রানজ্যাকশন হল একটি প্রক্রিয়া যা ডাটাবেসের একাধিক অপারেশনকে একক ইউনিটে গোষ্ঠীভুক্ত করে, যদি সব প্রক্রিয়া সফল হয় তবে সমস্ত পরিবর্তন কমিট করে, এবং কোনো ত্রুটি ঘটলে সমস্ত পরিবর্তন রোলব্যাক করে।

Characteristics of transactions

• ACID বৈশিষ্ট্য
• অ্যাটোমিসিটি : সব অপারেশন হয় সফলভাবে সম্পন্ন হয় অথবা কোনোটি প্রয়োগ হয় না।
• কনসিস্টেন্সি : ডেটা অখণ্ডতা বজায় থাকে।
• আইসোলেশন : সমসাময়িক ট্রানজ্যাকশনগুলি একে অপরকে প্রভাবিত করে না।
• ডিউরেবিলিটি : একবার কমিট হলে, পরিবর্তনগুলি স্থায়ীভাবে সংরক্ষিত হয়।

Basic transaction operations (COMMIT and ROLLBACK)

মেরিয়াডিবি ট্রানজ্যাকশনগুলি নিম্নলিখিত কমান্ডগুলির মাধ্যমে নিয়ন্ত্রণ করা যায়:

Using transactions in Python

নিচে মেরিয়াডিবি ট্রানজ্যাকশনগুলি পাইথন ব্যবহার করে পরিচালনার একটি মৌলিক উদাহরণ দেওয়া হয়েছে।

Managing multiple operations within a single transaction

নিম্নলিখিত কোড একাধিক ইনসার্ট অপারেশনকে একটি ট্রানজ্যাকশন হিসেবে বিবেচনা করে এবং শুধুমাত্র সব অপারেশন সফল হলে কমিট করে।

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() ব্যবহার করে পরিবর্তনগুলি বাতিল করুন এবং মূল অবস্থায় পুনরুদ্ধার করুন।

Transaction-based error handling

ডাটাবেস অপারেশনের সময় ত্রুটি ঘটতে পারে। উদাহরণস্বরূপ, ডুপ্লিকেট ইমেইল ঠিকানা (UNIQUE কনস্ট্রেইন্ট ভায়োলেশন) অথবা সার্ভার টাইমআউট ঘটতে পারে।

Transaction management with error handling

নিম্নলিখিত কোডে এমন লজিক যোগ করা হয়েছে যা প্রক্রিয়াকরণের সময় কোনো ত্রুটি ঘটলে পরিবর্তনগুলি রোলব্যাক করে এবং মূল অবস্থায় পুনরুদ্ধার করে।

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}")

Summary

এই বিভাগে, আমরা ট্রানজ্যাকশনের মৌলিক বিষয় এবং সেগুলি পাইথনে কীভাবে বাস্তবায়ন করা যায় তা ব্যাখ্যা করেছি।

• ট্রানজ্যাকশন এবং ACID বৈশিষ্ট্যের গুরুত্ব
• পাইথনে 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"))

সারাংশ

এই বিভাগে, আমরা পাইথনে MariaDB ব্যবহার করার সময় ঘটে যাওয়া সাধারণ ত্রুটিগুলি এবং সেগুলি কীভাবে সমাধান করা যায় তা ব্যাখ্যা করেছি।

• Access denied for user (প্রমাণীকরণ ত্রুটি)
• Can't connect to MySQL server (সংযোগ ত্রুটি)
• Unknown database (ডাটাবেস বিদ্যমান নয়)
• Table doesn't exist (টেবিল বিদ্যমান নয়)
• Duplicate entry (ডুপ্লিকেট ডেটা ত্রুটি)
• Incorrect number of bindings (প্যারামিটার সংখ্যা মেলেনি)

৮. উপসংহার

এই প্রবন্ধে, আমরা পাইথন ব্যবহার করে MariaDB নিয়ে কাজ করা কীভাবে হয়, মৌলিক ধারণা থেকে আরও উন্নত বিষয় পর্যন্ত ব্যাখ্যা করেছি।
মৌলিক ডাটাবেস অপারেশনগুলি বোঝা এবং সঠিকভাবে ত্রুটি হ্যান্ডলিং ও লেনদেন ব্যবস্থাপনা প্রয়োগের মাধ্যমে, আপনি আরও নিরাপদ এবং কার্যকর ডেটা অপারেশন করতে পারবেন।

প্রবন্ধের সংক্ষিপ্তসার

পরিবেশ সেটআপ

• কিভাবে MariaDB ইনস্টল করবেন (Windows / Mac / Linux)
• পাইথনের জন্য MariaDB কানেক্টর লাইব্রেরি (mariadb) কীভাবে ইনস্টল করবেন

MariaDB-তে সংযোগ

• মৌলিক ডাটাবেস সংযোগ পদ্ধতি
• পরিবেশ ভেরিয়েবল ব্যবহার করে নিরাপদ সংযোগ
• সাধারণ সংযোগ ত্রুটির সমাধান

ডাটাবেস এবং টেবিল তৈরি

• ডাটাবেস তৈরি (SQL / পাইথন)
• টেবিল তৈরি এবং ডেটা টাইপ নির্বাচন
• বিদ্যমান টেবিল পরীক্ষা এবং মুছে ফেলা

CRUD অপারেশন (Create, Read, Update, Delete)

• পাইথন ব্যবহার করে মৌলিক ডেটা অপারেশন
• SQL ইনজেকশন রোধে প্লেসহোল্ডার ব্যবহার
• সঠিক ত্রুটি হ্যান্ডলিং

লেনদেন এবং রোলব্যাক

• লেনদেনের গুরুত্ব (ACID বৈশিষ্ট্য)
• ত্রুটির সময় ডেটা পুনরুদ্ধার (রোলব্যাক) কীভাবে করবেন
• AutoCommit নিষ্ক্রিয় করে ম্যানুয়ালি লেনদেন পরিচালনা

ত্রুটি হ্যান্ডলিং (সাধারণ ত্রুটি এবং সমাধান)

• প্রমাণীকরণ ত্রুটি (Access denied for user)
• সংযোগ ত্রুটি (Can't connect to MySQL server)
• ডাটাবেস বা টেবিল না পাওয়া ত্রুটি
• ডুপ্লিকেট ডেটা ত্রুটি (Duplicate entry)
• ডেডলক হ্যান্ডলিং এবং রিট্রাই লজিক প্রয়োগ

পাইথন এবং 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. পারফরম্যান্স বিবেচনা করুন

• বাল্ক ইনসার্ট (একসাথে একাধিক রেকর্ড ইনসার্ট করা)
• সঠিক ইনডেক্সিং (সার্চ পারফরম্যান্স উন্নত করা)

আরও শিখতে রিসোর্স

যদি আপনি পাইথন এবং 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 – পাইথনের সেরা অনুশীলন শিখুন

সারাংশ

MariaDB-কে পাইথনের সঙ্গে একত্রিত করে, আপনি স্ক্রিপ্ট-ভিত্তিক ডেটা ম্যানেজমেন্ট এবং অটোমেশন সক্ষম করতে পারেন।
মৌলিক CRUD অপারেশনগুলির পাশাপাশি সঠিক ত্রুটি হ্যান্ডলিং এবং লেনদেন ব্যবস্থাপনা প্রয়োগের মাধ্যমে, আপনি একটি নিরাপদ এবং আরও কার্যকর সিস্টেম গড়ে তুলতে পারেন।

পরবর্তী ধাপে, আপনার জ্ঞানকে ব্যবহারিক ডেটাবেস অপারেশনে প্রয়োগ করার জন্য দক্ষ ডেটা ম্যানেজমেন্ট এবং API ইন্টিগ্রেশন সম্পর্কে শিখতে বিবেচনা করুন।