PL/SQL এবং REST API Integration

PL/SQL (Procedural Language/SQL) হচ্ছে Oracle ডেটাবেসের একটি প্রোগ্রামিং ভাষা যা SQL এর সাথে শক্তিশালী প্রসেসিং এবং লজিক্যাল প্রক্রিয়া সম্পাদন করার জন্য ব্যবহৃত হয়। REST (Representational State Transfer) API হল একটি জনপ্রিয় প্রোটোকল যা সার্ভার এবং ক্লায়েন্টের মধ্যে কমিউনিকেশন স্থাপন করতে ব্যবহৃত হয়, বিশেষত ওয়েব-ভিত্তিক অ্যাপ্লিকেশনগুলিতে। PL/SQL এর সাথে REST API ইন্টিগ্রেশন এমন একটি প্রক্রিয়া, যা Oracle ডেটাবেসের মাধ্যমে RESTful API কল করতে এবং সেই API থেকে ডেটা প্রাপ্তি এবং পরিচালনা করতে সাহায্য করে।

এই ইন্টিগ্রেশনটির মাধ্যমে, আপনি PL/SQL কোড ব্যবহার করে অন্য সিস্টেমের REST API গুলিকে কল করতে পারেন, এবং সেই API এর মাধ্যমে আসা ডেটা আপনার ডেটাবেসে সংরক্ষণ করতে পারেন অথবা ব্যবহার করতে পারেন।

PL/SQL এ REST API Integration এর জন্য উপায়

১. Oracle REST Data Services (ORDS)

Oracle REST Data Services (ORDS) হল একটি Oracle টুল, যা Oracle ডেটাবেসকে REST API হিসেবে এক্সপোজ করতে ব্যবহৃত হয়। ORDS প্লাগইনটি Oracle DB এর মাধ্যমে RESTful API কলের সুবিধা প্রদান করে, এবং আপনি PL/SQL ব্যবহার করে এই API গুলি কল করতে পারেন। এটি একটি সহজ এবং শক্তিশালী উপায় যাতে Oracle DB কে ওয়েব-ভিত্তিক REST API সার্ভার হিসেবে ব্যবহার করা যায়।

ORDS সেটআপের মাধ্যমে, আপনি HTTP requests পাঠানোর মাধ্যমে RESTful APIs কল করতে পারেন এবং PL/SQL ব্লক ব্যবহার করে এসব API থেকে ডেটা পেতে পারেন।

২. UTL_HTTP প্যাকেজ ব্যবহার

PL/SQL এর UTL_HTTP প্যাকেজ ব্যবহার করে, আপনি HTTP প্রোটোকল ব্যবহার করে RESTful API কল করতে পারবেন। এটি একটি PL/SQL প্যাকেজ যা Oracle ডেটাবেস থেকে HTTP রিকোয়েস্ট পাঠানোর জন্য ব্যবহৃত হয়।

UTL_HTTP প্যাকেজ দিয়ে REST API কল

UTL_HTTP প্যাকেজটি ব্যবহার করে REST API কল করার জন্য, নিচের পদক্ষেপগুলি অনুসরণ করতে হয়:

ধাপ ১: UTL_HTTP প্যাকেজের জন্য পারমিশন দেওয়া

প্রথমে, আপনাকে ডেটাবেস ব্যবহারকারীকে UTL_HTTP প্যাকেজ ব্যবহার করার অনুমতি দিতে হবে।

GRANT EXECUTE ON SYS.UTL_HTTP TO your_user;

ধাপ ২: HTTP Request তৈরি করা

এবার UTL_HTTP প্যাকেজের সাহায্যে HTTP GET বা POST রিকোয়েস্ট তৈরি করা যাবে। এখানে একটি GET রিকোয়েস্টের উদাহরণ দেওয়া হলো, যা একটি REST API কল করবে এবং তার থেকে ডেটা ফেরত আনবে।

DECLARE
    req   UTL_HTTP.REQ;
    resp  UTL_HTTP.RESP;
    buffer VARCHAR2(32767);
BEGIN
    -- HTTP GET রিকোয়েস্ট তৈরি করা
    req := UTL_HTTP.BEGIN_REQUEST('https://api.example.com/data', 'GET', UTL_HTTP.HTTP_VERSION_1_1);
    
    -- API থেকে রেসপন্স পাওয়া
    resp := UTL_HTTP.GET_RESPONSE(req);
    
    -- রেসপন্স লোড করা
    LOOP
        UTL_HTTP.READ_TEXT(resp, buffer);
        DBMS_OUTPUT.PUT_LINE(buffer);
    END LOOP;
    
    -- রেসপন্স শেষ হলে
    UTL_HTTP.END_RESPONSE(resp);
END;

উপরের কোডে:

• BEGIN_REQUEST ব্যবহার করা হয়েছে URL এবং HTTP মেথড (GET) এর জন্য।
• GET_RESPONSE ব্যবহার করে API থেকে রেসপন্স নেওয়া হচ্ছে।
• READ_TEXT ফাংশন ব্যবহার করে রেসপন্সের কনটেন্ট পাওয়া হচ্ছে।
• DBMS_OUTPUT.PUT_LINE ব্যবহার করে ফলাফল প্রদর্শন করা হচ্ছে।

ধাপ ৩: POST Request তৈরি করা

যদি POST রিকোয়েস্ট পাঠাতে চান, তবে আপনি UTL_HTTP এর POST মেথড ব্যবহার করবেন। নিচে একটি POST রিকোয়েস্টের উদাহরণ দেওয়া হলো:

DECLARE
    req   UTL_HTTP.REQ;
    resp  UTL_HTTP.RESP;
    buffer VARCHAR2(32767);
BEGIN
    -- HTTP POST রিকোয়েস্ট তৈরি করা
    req := UTL_HTTP.BEGIN_REQUEST('https://api.example.com/submit', 'POST', UTL_HTTP.HTTP_VERSION_1_1);
    
    -- POST ডেটা সেট করা
    UTL_HTTP.SET_HEADER(req, 'Content-Type', 'application/json');
    UTL_HTTP.WRITE_TEXT(req, '{"name": "John", "age": 30}');
    
    -- রেসপন্স পাওয়া
    resp := UTL_HTTP.GET_RESPONSE(req);
    
    -- রেসপন্স লোড করা
    LOOP
        UTL_HTTP.READ_TEXT(resp, buffer);
        DBMS_OUTPUT.PUT_LINE(buffer);
    END LOOP;
    
    -- রেসপন্স শেষ হলে
    UTL_HTTP.END_RESPONSE(resp);
END;

এখানে:

• SET_HEADER ব্যবহার করে Content-Type হেডার সেট করা হয়েছে।
• WRITE_TEXT ফাংশন ব্যবহার করে POST ডেটা পাঠানো হচ্ছে।

ধাপ ৪: API থেকে JSON ডেটা প্রাপ্তি

যদি আপনি JSON ডেটা প্রাপ্তি করতে চান, তাহলে API থেকে JSON রেসপন্স পার্স করার জন্য JSON_VALUE বা JSON_TABLE ফাংশন ব্যবহার করতে পারেন।

DECLARE
    req   UTL_HTTP.REQ;
    resp  UTL_HTTP.RESP;
    buffer VARCHAR2(32767);
    json_data VARCHAR2(4000);
BEGIN
    req := UTL_HTTP.BEGIN_REQUEST('https://api.example.com/data', 'GET', UTL_HTTP.HTTP_VERSION_1_1);
    resp := UTL_HTTP.GET_RESPONSE(req);
    
    LOOP
        UTL_HTTP.READ_TEXT(resp, buffer);
        json_data := buffer;
        EXIT WHEN UTL_HTTP.IS_RESPONSE_DONE(resp);
    END LOOP;
    
    -- JSON ডেটা প্রাপ্তি
    DBMS_OUTPUT.PUT_LINE('Received JSON: ' || json_data);
    
    -- JSON ডেটা পার্স করা
    SELECT JSON_VALUE(json_data, '$.employee.name') FROM DUAL;
    
    UTL_HTTP.END_RESPONSE(resp);
END;

এখানে:

• API থেকে JSON রেসপন্স পাওয়া হচ্ছে এবং JSON_VALUE ফাংশন ব্যবহার করে JSON ডেটা থেকে নির্দিষ্ট তথ্য বের করা হচ্ছে।

PL/SQL দিয়ে REST API তৈরি করা

Oracle REST Data Services (ORDS) এর মাধ্যমে PL/SQL কোড ব্যবহার করে REST API তৈরি করা সম্ভব। এটি Oracle DB-এর মধ্যে রিলেশনাল ডেটাকে RESTful API হিসাবে এক্সপোজ করতে সাহায্য করে।

ORDS এর মাধ্যমে REST API তৈরি করার উদাহরণ:

1. ORDS ইনস্টল করে আপনার Oracle DB-এর মধ্যে একটি RESTful সার্ভিস তৈরি করুন।
2. তারপর, একটি PL/SQL স্টোরড প্রসিডিউর বা ফাংশন তৈরি করুন যা HTTP রিকোয়েস্টের মাধ্যমে JSON ডেটা ফিরিয়ে দিবে।

ORDS ব্যবহার করে REST API তৈরি করার পর, আপনি সেই API এর মাধ্যমে ডেটাবেসের বিভিন্ন তথ্য অ্যাক্সেস এবং ম্যানিপুলেট করতে পারবেন।

উপসংহার

PL/SQL এবং REST API ইন্টিগ্রেশন আপনাকে Oracle ডেটাবেস থেকে বাইরের API গুলির সাথে ইন্টারঅ্যাক্ট করতে সক্ষম করে। এটি আপনাকে HTTP রিকোয়েস্ট এবং রেসপন্সের মাধ্যমে বাইরের সিস্টেম থেকে ডেটা আনতে এবং সেই ডেটা আপনার ডেটাবেসে সংরক্ষণ করতে সাহায্য করে। Oracle এর UTL_HTTP প্যাকেজ এবং ORDS টুল ব্যবহার করে এই ইন্টিগ্রেশনটি সহজেই করা যায়।

PL/SQL দিয়ে REST API তৈরি করা Oracle Database-এর মধ্যে বহুল ব্যবহৃত একটি কৌশল, যা ডাটাবেসের সঙ্গে যোগাযোগ স্থাপন করার জন্য HTTP সার্ভিসের মাধ্যমে ডেটা অ্যাক্সেস এবং ম্যানিপুলেশন করতে ব্যবহৃত হয়। Oracle Database-এ REST API তৈরি করার জন্য Oracle REST Data Services (ORDS) ব্যবহার করা হয়।

ORDS-এর মাধ্যমে PL/SQL ফাংশন এবং প্রোসিডিউরগুলি HTTP রিকোয়েস্ট হিসেবে এক্সপোজ করা সম্ভব হয়। এটি Oracle Database এর মধ্যে থাকা ডেটা এবং লজিককে ওয়েব অ্যাপ্লিকেশন এবং অন্যান্য ক্লায়েন্ট অ্যাপ্লিকেশনগুলির জন্য সহজে অ্যাক্সেসযোগ্য করে তোলে।

Oracle REST Data Services (ORDS) পরিচিতি

ORDS হল Oracle-এর একটি টুল যা Oracle Database-এর ডেটাকে RESTful Web Services-এ রূপান্তর করতে ব্যবহৃত হয়। ORDS প্লাগইনটি Oracle Application Server-এর সাথে ইন্টিগ্রেটেড থাকে এবং HTTP সার্ভার হিসেবে কাজ করে। এর মাধ্যমে PL/SQL কোড ও ডেটাবেস ফাংশনালিটি REST API হিসেবে এক্সপোজ করা সম্ভব হয়।

PL/SQL দিয়ে REST API তৈরি করার স্টেপগুলি:

১. ORDS ইনস্টলেশন এবং কনফিগারেশন

ORDS সেটআপ করার জন্য প্রথমে আপনাকে ORDS ইন্সটল এবং কনফিগার করতে হবে। যদি আপনি ইতিমধ্যেই ORDS ব্যবহার করছেন, তবে এই স্টেপটি পাস করতে পারেন। যদি না থাকে, তাহলে আপনাকে Oracle REST Data Services-এর সর্বশেষ সংস্করণ ডাউনলোড এবং ইনস্টল করতে হবে।

ORDS ইন্সটলেশন:

ORDS ইনস্টল করার জন্য নিচের কমান্ড ব্যবহার করতে পারেন:

java -jar ords.war setup

এটি ORDS-এর কনফিগারেশন শুরু করবে এবং আপনার Oracle Database-এর সঙ্গে সংযোগ স্থাপন করবে।

২. Oracle Database এ Web Services সক্রিয় করা

ORDS সক্রিয় করার জন্য আপনাকে আপনার Oracle Database-এ Web Services সক্রিয় করতে হবে।

-- Ensure the required schema exists
CREATE USER ords_user IDENTIFIED BY ords_password;
GRANT CONNECT, RESOURCE TO ords_user;

-- Assign the necessary roles
GRANT EXECUTE ON SYS.ORDS_ADMIN TO ords_user;

এটি ORDS স্কিমা তৈরি করবে এবং ব্যবহারকারীর জন্য প্রয়োজনীয় অনুমতি প্রদান করবে।

৩. REST API এর জন্য PL/SQL প্রোগ্রাম তৈরি করা

এখন আপনি PL/SQL ফাংশন বা প্রোসিডিউর তৈরি করবেন, যা REST API-এর জন্য HTTP রিকোয়েস্ট গ্রহণ করবে এবং ডেটাবেসের সাথে যোগাযোগ করবে।

উদাহরণস্বরূপ, একটি PL/SQL ফাংশন তৈরি করুন যা একটি ইম্প্লিমেন্টেশন করে যেটি একজন কর্মচারীর তথ্য ফেরত দেবে:

CREATE OR REPLACE FUNCTION get_employee_details (p_employee_id IN NUMBER) 
   RETURN VARCHAR2 IS
   v_result VARCHAR2(4000);
BEGIN
   SELECT 'Employee Name: ' || employee_name || ', Department: ' || department_id
   INTO v_result
   FROM employees
   WHERE employee_id = p_employee_id;
   
   RETURN v_result;
EXCEPTION
   WHEN NO_DATA_FOUND THEN
      RETURN 'Employee not found';
   WHEN OTHERS THEN
      RETURN 'Error occurred';
END;

এই ফাংশনটি একটি কর্মচারীর আইডি গ্রহণ করবে এবং তার নাম ও ডিপার্টমেন্ট ফেরত দেবে।

৪. ORDS দিয়ে REST API এক্সপোজ করা

ORDS এর মাধ্যমে আপনি আপনার PL/SQL কোডকে RESTful API হিসাবে এক্সপোজ করতে পারেন।

ORDS-এর মাধ্যমে ফাংশন এবং প্রোসিডিউর এক্সপোজ করতে, RESTful Service তৈরি করতে হবে।

1. RESTful Service তৈরি করা: Oracle SQL Developer অথবা ORDS কনফিগারেশন প্যানেল ব্যবহার করে RESTful সার্ভিস তৈরি করা যায়।

   • SQL Developer খুলুন
   • Tools -> Oracle REST Data Services -> RESTful Services নির্বাচন করুন
   • একটি নতুন RESTful সার্ভিস তৈরি করুন এবং ফাংশন বা প্রোসিডিউরটি এক্সপোজ করুন

   উদাহরণস্বরূপ, যদি আপনি উপরের get_employee_details ফাংশনটি RESTful API হিসাবে এক্সপোজ করতে চান, তাহলে এটি এমন কিছু দেখতে পারে:

   BEGIN
      ORDS.DEFINE_SERVICE(
         p_module_name    => 'employee_service',
         p_base_path      => '/employees/',
         p_pattern         => 'get/{employee_id}',
         p_source_type    => 'plsql',
         p_source         => 'BEGIN :response := get_employee_details(:employee_id); END;'
      );
      COMMIT;
   END;
   

   এখানে get_employee_details ফাংশনটি /employees/get/{employee_id} রুটে এক্সপোজ করা হবে।

৫. API কনফিগারেশন এবং টেস্টিং

একবার RESTful সার্ভিস তৈরি হয়ে গেলে, আপনি এটি পরীক্ষা করতে পারবেন। আপনি Postman বা cURL এর মতো টুলস ব্যবহার করে API-টির HTTP রিকোয়েস্ট পাঠাতে পারেন।

উদাহরণস্বরূপ, Postman এর মাধ্যমে GET রিকোয়েস্ট পাঠান:

GET http://<hostname>:<port>/ords/employees/get/101

এটি { "Employee Name": "John Doe", "Department": "10" } এর মতো JSON রেসপন্স ফিরিয়ে দিবে (যদি কর্মচারী 101-এর ডেটা থাকে)।

৬. Error Handling এবং Response Formatting

ORDS-এ Error Handling এবং Response Formatting খুবই গুরুত্বপূর্ণ। আপনি REST API থেকে JSON বা XML ফরম্যাটে ডেটা পাঠানোর জন্য কোড এবং রেসপন্সের কাঠামো নির্ধারণ করতে পারেন। এর জন্য DBMS_OUTPUT বা RAISE_APPLICATION_ERROR ব্যবহার করে সঠিক ত্রুটি বার্তা তৈরি করতে পারেন।

DECLARE
   v_result VARCHAR2(4000);
BEGIN
   -- Example to handle error
   BEGIN
      SELECT 'Employee Name: ' || employee_name
      INTO v_result
      FROM employees
      WHERE employee_id = :employee_id;
   EXCEPTION
      WHEN NO_DATA_FOUND THEN
         RAISE_APPLICATION_ERROR(-20001, 'Employee not found');
   END;

   :response := v_result;  -- Returning result as response
END;

৭. REST API উন্নত কনফিগারেশন

ORDS-এ REST API আরো উন্নত কনফিগারেশন করতে আপনি বিভিন্ন ধরনের মেথড যেমন POST, PUT, DELETE ইত্যাদি ব্যবহার করতে পারেন, এবং ডেটা ইনসার্ট বা আপডেটের জন্য HTTP রিকোয়েস্ট কনফিগার করতে পারেন।

উপসংহার

PL/SQL দিয়ে REST API তৈরি একটি শক্তিশালী এবং কার্যকরী পদ্ধতি যা Oracle Database-এর সাথে অন্য অ্যাপ্লিকেশন এবং সিস্টেমগুলির মধ্যে একসাথে কাজ করতে সক্ষম করে। ORDS-এর সাহায্যে আপনি সহজে PL/SQL কোডের সাথে RESTful Web Services তৈরি করতে পারেন, যা ডেটাবেস অ্যাপ্লিকেশনের কার্যকারিতা এবং ইন্টিগ্রেশন আরও উন্নত করে।

ORDS (Oracle REST Data Services) হল একটি Oracle পণ্য যা SQL এবং PL/SQL কোডের মাধ্যমে RESTful ওয়েব সার্ভিস তৈরি করার জন্য ব্যবহৃত হয়। এটি একটি আধুনিক, স্কেলেবল এবং সিকিউর ওয়েব সার্ভিস প্ল্যাটফর্ম যা আপনাকে Oracle ডেটাবেসের সাথে সহজে ইন্টিগ্রেটেড REST API তৈরি করতে সহায়তা করে।

ORDS ব্যবহার করে, আপনি আপনার Oracle ডেটাবেসের টেবিল, ভিউ, স্টোরড প্রোসিডিউর ইত্যাদির জন্য RESTful API তৈরি করতে পারেন। এই API গুলি সাধারণ HTTP রিকোয়েস্ট (GET, POST, PUT, DELETE) এর মাধ্যমে অ্যাক্সেস করা যায়।

ORDS এর মূল বৈশিষ্ট্য

• RESTful Web Services: HTTP এবং REST প্রটোকলের মাধ্যমে ডেটাবেস অ্যাক্সেস প্রদান।
• JSON এবং XML সমর্থন: ডেটাবেসের আউটপুট JSON অথবা XML ফরম্যাটে প্রদান করা যায়।
• SQL এবং PL/SQL ইন্টিগ্রেশন: ডেটাবেসের SQL কুয়েরি এবং PL/SQL প্রোসিডিউর এক্সিকিউট করার জন্য API তৈরি করা যায়।
• অটোমেটিক ডকুমেন্টেশন: ORDS স্বয়ংক্রিয়ভাবে ডকুমেন্টেশন তৈরি করতে সক্ষম যা API এর ব্যবহারকারীদের জন্য খুবই সুবিধাজনক।

ORDS ব্যবহার শুরু করা

ORDS সেটআপ এবং ব্যবহার শুরু করতে হলে প্রথমে আপনাকে ORDS ইনস্টল করতে হবে। এরপর, আপনার Oracle ডেটাবেসের সাথে সংযুক্ত করে, RESTful API তৈরি করা যাবে। নিচে ORDS ব্যবহার করার জন্য কিছু মূল ধাপ দেয়া হলো।

১. ORDS ইনস্টলেশন

ORDS ইনস্টল করতে, আপনাকে প্রথমে Oracle ডেটাবেসে সংযুক্ত থাকতে হবে এবং ORDS প্যাকেজটি ডাউনলোড করতে হবে। ইনস্টলেশনের জন্য কয়েকটি ধাপ অনুসরণ করতে হয়:

Steps for Installation:

• ডাউনলোড করুন ORDS zip ফাইল Oracle Download Link
• ইনস্টলেশন ডিরেক্টরি তৈরি করুন এবং zip ফাইল এক্সট্র্যাক্ট করুন।
• INI ফাইল কনফিগার করুন যেখানে ডেটাবেসের সংযোগ তথ্য থাকবে।

java -jar ord.war setup

• ডেটাবেস সংযোগের জন্য ORDS কনফিগার করুন:

java -jar ord.war config

২. ORDS সার্ভার চালু করা

ORDS সফলভাবে ইনস্টল হওয়ার পর, আপনাকে এটি চালু করতে হবে। নিচের কমান্ড দিয়ে ORDS সার্ভার চালু করা যাবে:

java -jar ord.war

এটি চালানোর পর, ORDS ওয়েব সার্ভিস চালু হয়ে যাবে এবং আপনি নির্দিষ্ট URL এর মাধ্যমে API অ্যাক্সেস করতে পারবেন। সাধারণত ORDS 8080 পোর্টে চলে, যেমন:

http://localhost:8080/ords/

৩. RESTful Service তৈরি করা

ORDS ব্যবহার করে RESTful সেবা তৈরি করতে আপনাকে SQL বা PL/SQL কোডের মাধ্যমে API তৈরি করতে হবে। এর জন্য নিচে একটি সাধারণ উদাহরণ দেয়া হলো।

Example: Basic GET API Creation

ধরা যাক, আমাদের একটি employees টেবিল রয়েছে, যার মধ্যে কর্মচারীদের তথ্য রয়েছে। আমরা এই টেবিল থেকে কর্মচারীর ডেটা বের করতে একটি RESTful API তৈরি করব।

Step 1: SQL স্ক্রিপ্ট ব্যবহার করে ORDS RESTful সার্ভিস তৈরি:

BEGIN
   ORDS.ENABLE_OBJECT('HR.EMPLOYEES', 'GET');
END;
/

এটি HR.EMPLOYEES টেবিলের জন্য একটি GET API তৈরি করবে। এরপর, আপনি নিচের URL ব্যবহার করে এই টেবিল থেকে ডেটা GET করতে পারবেন:

http://localhost:8080/ords/hr/employees/

এটি আপনার টেবিলের সমস্ত ডেটা JSON ফরম্যাটে ফিরিয়ে দেবে।

৪. Advanced Example: POST Method Using PL/SQL

যদি আপনি একটি POST রিকোয়েস্ট তৈরি করতে চান যা ডেটাবেসে ডেটা ইনসার্ট করবে, তবে আপনাকে PL/SQL ব্লক তৈরি করতে হবে।

Step 1: PL/SQL প্রোসিডিউর তৈরি করা:

CREATE OR REPLACE PROCEDURE insert_employee (
    p_first_name IN VARCHAR2,
    p_last_name IN VARCHAR2,
    p_email IN VARCHAR2,
    p_salary IN NUMBER
) AS
BEGIN
    INSERT INTO employees (first_name, last_name, email, salary)
    VALUES (p_first_name, p_last_name, p_email, p_salary);
END;
/

Step 2: POST API তৈরি করা:

BEGIN
   ORDS.DEFINE_SERVICE(
      p_module_name => 'Employee_Service',
      p_base_path => '/employees/',
      p_pattern => 'insert',
      p_source_type => 'PLSQL',
      p_source => 'BEGIN insert_employee(:first_name, :last_name, :email, :salary); END;'
   );
END;
/

এটি একটি POST API তৈরি করবে যা HTTP রিকোয়েস্টের মাধ্যমে ডেটাবেসে নতুন কর্মচারী ইনপুট করতে পারবে।

API URL:

http://localhost:8080/ords/hr/employees/insert

POST Data (JSON Format):

{
  "first_name": "John",
  "last_name": "Doe",
  "email": "john.doe@example.com",
  "salary": 5000
}

এই POST রিকোয়েস্টটি API এ পাঠালে নতুন কর্মচারী ডেটা employees টেবিলে ইনসার্ট হবে।

৫. API Authentication and Security

ORDS API গুলির জন্য অটেনটিকেশন এবং সিকিউরিটি সেট করা গুরুত্বপূর্ণ। ORDS বিভিন্ন ধরনের অটেনটিকেশন সাপোর্ট করে, যেমন:

• Basic Authentication: API এ অ্যাক্সেস করতে ইউজারনেম এবং পাসওয়ার্ড প্রদান।
• OAuth2: Advanced API security ব্যবস্থার জন্য।
• SSL/TLS: সংবেদনশীল ডেটা সুরক্ষিতভাবে ট্রান্সফার করার জন্য।

ORDS সিকিউরিটি কনফিগার করার জন্য আপনাকে ords.war ফাইলে উপযুক্ত কনফিগারেশন করতে হবে এবং HTTPS অ্যাক্সেসের জন্য SSL সার্টিফিকেট ব্যবহার করতে হবে।

ORDS এর ব্যবহারিক প্রয়োগ

ORDS এর সাহায্যে আপনি নিম্নলিখিত কার্যকলাপগুলি করতে পারবেন:

1. Data Extraction: ডেটাবেস থেকে ডেটা JSON বা XML আউটপুট ফরম্যাটে বের করা।
2. Data Manipulation: ডেটাবেসে ডেটা ইনসার্ট, আপডেট বা ডিলিট করা।
3. Report Generation: ডেটাবেসের ডেটার উপর ভিত্তি করে রিপোর্ট তৈরি করা।
4. Application Integration: ওয়েব এবং মোবাইল অ্যাপ্লিকেশনের সাথে ডেটাবেস ইন্টিগ্রেশন করা।

উপসংহার

ORDS একটি শক্তিশালী টুল যা আপনাকে Oracle ডেটাবেসের ডেটাকে সহজে ওয়েব অ্যাপ্লিকেশন এবং মোবাইল অ্যাপ্লিকেশনে এক্সপোজ করার সুযোগ দেয়। এর মাধ্যমে, আপনি আপনার Oracle ডেটাবেসের উপর RESTful API তৈরি করতে পারেন যা নিরাপদ, স্কেলেবল এবং সুবিধাজনক। ORDS এর সাহায্যে RESTful ওয়েব সার্ভিস তৈরি করা এখন অনেক সহজ এবং দ্রুততর হয়েছে।

Oracle PL/SQL এ JSON এবং XML ডেটা প্রক্রিয়াকরণ একটি গুরুত্বপূর্ণ এবং সাধারণ কাজ। PL/SQL এর মাধ্যমে আপনি JSON এবং XML ডেটা তৈরি, পার্স, এবং শেয়ার করতে পারেন। এটি REST API এর মাধ্যমে ডেটা প্রেরণ, ইনপুট গ্রহণ, এবং আরও অনেক কেসে ব্যবহৃত হয়। এই টিউটোরিয়ালে আমরা দেখব কিভাবে PL/SQL এর মাধ্যমে JSON এবং XML ডেটা শেয়ার করা যায়।

PL/SQL দিয়ে JSON ডেটা শেয়ার করা

Oracle 12c থেকে JSON সাপোর্ট শুরু হয়েছে, এবং আপনি PL/SQL এর মাধ্যমে JSON ডেটা তৈরি ও প্রক্রিয়া করতে পারবেন। Oracle JSON সাপোর্টের জন্য বিভিন্ন প্যাকেজ এবং ফাংশন সরবরাহ করে, যেমন JSON_OBJECT, JSON_ARRAY, JSON_OBJECT_T, এবং JSON_ARRAY_T।

JSON তৈরি করা:

PL/SQL এ JSON ডেটা তৈরি করতে JSON_OBJECT ফাংশন ব্যবহার করা হয়। নিচে একটি উদাহরণ দেওয়া হল, যেখানে একটি সিঙ্গেল JSON অবজেক্ট তৈরি করা হয়েছে:

DECLARE
    v_json_obj JSON_OBJECT_T;
BEGIN
    -- JSON অবজেক্ট তৈরি
    v_json_obj := JSON_OBJECT('name' VALUE 'John Doe', 'age' VALUE 30, 'city' VALUE 'Dhaka');
    
    -- JSON আউটপুট প্রিন্ট করা
    DBMS_OUTPUT.PUT_LINE('Generated JSON: ' || v_json_obj.to_string);
END;
/

এখানে, একটি JSON_OBJECT_T টাইপের ভেরিয়েবল v_json_obj তৈরি করা হয়েছে, যা একটি JSON অবজেক্ট ধারণ করবে। এর মধ্যে name, age, এবং city নামক ফিল্ড রয়েছে। কোডটি JSON অবজেক্ট হিসেবে আউটপুট প্রদর্শন করবে:

Generated JSON: {"name":"John Doe","age":30,"city":"Dhaka"}

JSON ডেটা শেয়ার করা:

আপনি যদি এই JSON ডেটাকে REST API মাধ্যমে শেয়ার করতে চান, তবে আপনাকে Oracle REST Data Services (ORDS) ব্যবহার করতে হবে। ORDS JSON ডেটাকে HTTP response হিসেবে ফিরিয়ে দিতে পারে।

ORDS এর মাধ্যমে JSON শেয়ার করা উদাহরণ:

ORDS সেটআপ করার পর, নিচের মতো একটি API endpoint তৈরি করতে পারেন:

BEGIN
    -- RESTful API এর মাধ্যমে JSON রিটার্ন করা
    owa_util.http_header('Content-Type', 'application/json');
    owa_util.http_header('Cache-Control', 'no-cache');
    htp.p('{"status":"success","message":"Data shared successfully."}');
END;
/

এখানে, JSON ডেটা HTP.P কমান্ডের মাধ্যমে ক্লায়েন্টের কাছে পাঠানো হবে।

PL/SQL দিয়ে XML ডেটা শেয়ার করা

XML ডেটা প্রক্রিয়া করার জন্য Oracle একটি শক্তিশালী XML লাইব্রেরি সরবরাহ করে, যা দিয়ে আপনি XML তৈরি, পার্স, এবং শেয়ার করতে পারেন। আপনি DBMS_XMLGEN, DBMS_XMLDOM, এবং XMLTYPE প্যাকেজ ব্যবহার করতে পারেন।

XML তৈরি করা:

XML ডেটা তৈরি করতে XMLTYPE ব্যবহার করা হয়। নিচে একটি উদাহরণ দেওয়া হলো যেখানে একটি সিম্পল XML ডকুমেন্ট তৈরি করা হয়েছে:

DECLARE
    v_xml XMLTYPE;
BEGIN
    -- XML ডেটা তৈরি করা
    v_xml := XMLTYPE('<person><name>John Doe</name><age>30</age><city>Dhaka</city></person>');
    
    -- XML আউটপুট প্রিন্ট করা
    DBMS_OUTPUT.PUT_LINE('Generated XML: ' || v_xml.getStringVal());
END;
/

এখানে, একটি XMLTYPE টাইপের ভেরিয়েবল v_xml তৈরি করা হয়েছে, এবং এটি একটি XML ডকুমেন্ট ধারণ করে। আউটপুট হবে:

Generated XML: <person><name>John Doe</name><age>30</age><city>Dhaka</city></person>

XML ডেটা শেয়ার করা:

XML ডেটা শেয়ার করার জন্যও আপনি ORDS ব্যবহার করতে পারেন, যেখানে XML ডেটা HTTP response হিসেবে পাঠানো হবে। নিচের উদাহরণে দেখা যাচ্ছে কিভাবে XML ডেটা ORDS API এর মাধ্যমে শেয়ার করা যায়:

BEGIN
    -- XML ডেটা তৈরি করা
    owa_util.http_header('Content-Type', 'application/xml');
    owa_util.http_header('Cache-Control', 'no-cache');
    htp.p('<?xml version="1.0" encoding="UTF-8"?>
           <response>
               <status>success</status>
               <message>XML data shared successfully</message>
           </response>');
END;
/

এখানে, XML ডেটা HTP.P কমান্ডের মাধ্যমে ক্লায়েন্টের কাছে পাঠানো হবে।

PL/SQL দিয়ে JSON এবং XML এর সমন্বয়:

আপনি একই PL/SQL ব্লক বা API endpoint এর মধ্যে JSON এবং XML উভয় ডেটা শেয়ার করতে পারেন। উদাহরণস্বরূপ:

DECLARE
    v_json JSON_OBJECT_T;
    v_xml XMLTYPE;
BEGIN
    -- JSON তৈরি করা
    v_json := JSON_OBJECT('name' VALUE 'John Doe', 'age' VALUE 30, 'city' VALUE 'Dhaka');
    
    -- XML তৈরি করা
    v_xml := XMLTYPE('<person><name>John Doe</name><age>30</age><city>Dhaka</city></person>');
    
    -- JSON এবং XML শেয়ার করা
    owa_util.http_header('Content-Type', 'application/json');
    owa_util.http_header('Cache-Control', 'no-cache');
    htp.p(v_json.to_string);
    
    -- XML শেয়ার করা
    owa_util.http_header('Content-Type', 'application/xml');
    htp.p(v_xml.getStringVal);
END;
/

এখানে, প্রথমে JSON তৈরি করা হচ্ছে, পরে XML তৈরি করা হচ্ছে এবং উভয়ই আলাদা আলাদা হেডার দিয়ে HTTP response হিসেবে শেয়ার করা হচ্ছে।

সারাংশ

PL/SQL দিয়ে JSON এবং XML শেয়ার করার জন্য আপনি Oracle REST Data Services (ORDS), XMLTYPE, এবং JSON_OBJECT_T ব্যবহার করতে পারেন। JSON এবং XML ডেটা তৈরি, পাঠানো এবং শেয়ার করার জন্য Oracle এর অনেক শক্তিশালী ফিচার রয়েছে। আপনি JSON এবং XML ডেটা ব্যবহার করে RESTful API তৈরি করতে পারেন এবং এতে ডেটা শেয়ার করার জন্য সহজ ও দ্রুত সমাধান পাবেন।

PL/SQL দিয়ে Web API Integration করার মাধ্যমে আপনি বাহ্যিক সিস্টেমের সাথে যোগাযোগ করতে পারেন, যেমন REST API বা SOAP API। এই পদ্ধতি ব্যবহৃত হয় যখন আপনার PL/SQL কোড থেকে কোনো এক্সটার্নাল সেবা (যেমন, ওয়েব সার্ভিস) কল করতে হয়। Oracle Database এ Web API Integration সাধারাণভাবে UTL_HTTP বা APEX_WEB_SERVICE প্যাকেজের মাধ্যমে সম্পন্ন করা হয়।

এখানে, আমরা UTL_HTTP প্যাকেজ ব্যবহার করে একটি REST API কল করার উদাহরণ দেখব।

PL/SQL এর মাধ্যমে Web API Integration (REST API)

ধরা যাক, আমাদের একটি REST API রয়েছে যা একটি নির্দিষ্ট ইউআরএল থেকে JSON ডেটা ফেরত দেয়। আমরা এই API থেকে তথ্য গ্রহণ করতে চাই।

Step 1: UTL_HTTP প্যাকেজের মাধ্যমে Web API কল করা

PL/SQL তে UTL_HTTP প্যাকেজ ব্যবহার করে আপনি HTTP অনুরোধ পাঠাতে পারেন এবং তার উত্তর গ্রহণ করতে পারেন।

DECLARE
    -- Variable to hold the response from API
    l_response VARCHAR2(32767);
    -- API endpoint URL
    l_url VARCHAR2(200) := 'https://api.example.com/data';
    -- HTTP Request method
    l_http_req  UTL_HTTP.REQUEST;
BEGIN
    -- Open the HTTP request to the URL
    l_http_req := UTL_HTTP.BEGIN_REQUEST(l_url);
    
    -- Send the HTTP request and get the response
    UTL_HTTP.SET_HEADER(l_http_req, 'User-Agent', 'PLSQL API Client');
    
    -- Receive the response body
    UTL_HTTP.GET_RESPONSE(l_http_req, l_response);
    
    -- Print out the response for demonstration
    DBMS_OUTPUT.PUT_LINE('API Response: ' || l_response);
    
    -- End the HTTP request
    UTL_HTTP.END_REQUEST(l_http_req);
EXCEPTION
    WHEN UTL_HTTP.REQUEST_FAILED THEN
        DBMS_OUTPUT.PUT_LINE('Error: Failed to call API');
    WHEN OTHERS THEN
        DBMS_OUTPUT.PUT_LINE('Unexpected error: ' || SQLERRM);
END;

Explanation:

1. l_url: এটি সেই URL যা আপনি কল করতে চান (এখানে একটি উদাহরণ URL দেওয়া হয়েছে, তবে এটি আপনার API এর ইউআরএল হতে হবে)।
2. UTL_HTTP.BEGIN_REQUEST: এটি HTTP অনুরোধ শুরু করে।
3. UTL_HTTP.SET_HEADER: এটি HTTP হেডারে ইউজার এজেন্ট সেট করে।
4. UTL_HTTP.GET_RESPONSE: এটি HTTP অনুরোধ পাঠায় এবং তার মাধ্যমে API থেকে আসা রেসপন্স সংগ্রহ করে।
5. DBMS_OUTPUT.PUT_LINE: এটি রেসপন্স প্রিন্ট করে (এটা শুধু ডিবাগging এর জন্য, বাস্তবিক প্রয়োজনে ডেটা অন্যত্র স্টোর করা যেতে পারে)।
6. UTL_HTTP.END_REQUEST: এটি HTTP অনুরোধ সম্পন্ন করে।

Step 2: JSON Parsing (Optional)

যেহেতু অনেক Web API JSON রেসপন্স প্রদান করে, আপনি যদি JSON রেসপন্স নিতে চান, তাহলে আপনাকে JSON_OBJECT_T এবং JSON_ARRAY_T টাইপ ব্যবহার করে JSON পার্সিং করতে হবে।

DECLARE
    l_response VARCHAR2(32767);
    l_json_response JSON_OBJECT_T;
BEGIN
    -- Call the API as shown before and receive the response in 'l_response'
    -- Parsing the JSON response
    l_json_response := JSON_OBJECT_T.parse(l_response);

    -- Accessing a specific field from the JSON response (example: "name")
    DBMS_OUTPUT.PUT_LINE('Name: ' || l_json_response.get_string('name'));
    
EXCEPTION
    WHEN OTHERS THEN
        DBMS_OUTPUT.PUT_LINE('Error: ' || SQLERRM);
END;

Explanation:

• JSON_OBJECT_T.parse(l_response): এটি JSON স্ট্রিংকে একটি JSON অবজেক্টে রূপান্তরিত করে।
• get_string('name'): এটি JSON অবজেক্টের একটি ফিল্ড (যেমন 'name') এর মান গ্রহণ করে।

Step 3: Authentication (API Key or OAuth)

বহু ওয়েব API একটি নির্দিষ্ট ধরনের authentication চায়, যেমন API Key বা OAuth। সাধারণত, এটি HTTP হেডারের মাধ্যমে পাঠানো হয়।

উদাহরণস্বরূপ, যদি আপনাকে API Key ব্যবহার করে API কল করতে হয়:

DECLARE
    l_response VARCHAR2(32767);
    l_url VARCHAR2(200) := 'https://api.example.com/data';
    l_api_key VARCHAR2(50) := 'your_api_key_here';
    l_http_req  UTL_HTTP.REQUEST;
BEGIN
    -- Open the HTTP request to the URL
    l_http_req := UTL_HTTP.BEGIN_REQUEST(l_url);
    
    -- Set the API Key in the HTTP header
    UTL_HTTP.SET_HEADER(l_http_req, 'Authorization', 'Bearer ' || l_api_key);
    
    -- Receive the response body
    UTL_HTTP.GET_RESPONSE(l_http_req, l_response);
    
    -- Print out the response for demonstration
    DBMS_OUTPUT.PUT_LINE('API Response: ' || l_response);
    
    -- End the HTTP request
    UTL_HTTP.END_REQUEST(l_http_req);
EXCEPTION
    WHEN UTL_HTTP.REQUEST_FAILED THEN
        DBMS_OUTPUT.PUT_LINE('Error: Failed to call API');
    WHEN OTHERS THEN
        DBMS_OUTPUT.PUT_LINE('Unexpected error: ' || SQLERRM);
END;

Explanation:

• এখানে Authorization হেডার ব্যবহার করে Bearer টোকেন পাঠানো হচ্ছে, যা অনেক API authentication এর জন্য ব্যবহৃত হয়।

Step 4: Error Handling

API থেকে যখন রেসপন্স পাওয়া যায়, তখন অনেক সময় HTTP স্ট্যাটাস কোডের মাধ্যমে ত্রুটি জানানো হয় (যেমন, 400 বা 500 সিরিজ কোড)। আপনি এসব কোড চেক করে সঠিক ত্রুটি ব্যবস্থা গ্রহণ করতে পারেন।

DECLARE
    l_response VARCHAR2(32767);
    l_status_code NUMBER;
BEGIN
    -- Call API and get status code
    l_status_code := UTL_HTTP.REQUEST(l_url);
    
    -- Check status code
    IF l_status_code != 200 THEN
        DBMS_OUTPUT.PUT_LINE('Error: Received non-OK response ' || l_status_code);
    ELSE
        -- Handle valid response
        UTL_HTTP.GET_RESPONSE(l_http_req, l_response);
        DBMS_OUTPUT.PUT_LINE('API Response: ' || l_response);
    END IF;
    
EXCEPTION
    WHEN OTHERS THEN
        DBMS_OUTPUT.PUT_LINE('Unexpected error: ' || SQLERRM);
END;

Conclusion

PL/SQL এর মাধ্যমে Web API Integration এর সাহায্যে আপনি সহজেই বাহ্যিক সিস্টেমের সাথে যোগাযোগ করতে পারেন এবং ডেটা প্রাপ্তি ও প্রক্রিয়াকরণ করতে পারেন। উদাহরণস্বরূপ, UTL_HTTP প্যাকেজ ব্যবহার করে REST API কল করা এবং JSON ডেটা পার্সিং, এ ধরনের ইন্টিগ্রেশন টেকনিক গুলি খুবই কার্যকরী। API Authentication, Error Handling এবং JSON Parsing গুরুত্বপূর্ণ পদ্ধতিগুলি, যা আপনাকে API কল করার সময় সঠিকভাবে ত্রুটির মোকাবিলা করতে সাহায্য করবে।