การเปิดใช้งานการกรองสตริงที่ซ้ํากันในโปรเซสเซอร์ข้อความ

คุณกำลังดูเอกสารประกอบของ Apigee Edge
ไปที่เอกสารประกอบของ Apigee X ข้อมูล

เอกสารนี้จะอธิบายวิธีเปิดใช้การทำซ้ำสตริงในเครื่องมือประมวลผลข้อความของ Apigee Edge

การกรองสตริงซ้ำเป็นฟีเจอร์ของ Java ที่ช่วยให้คุณประหยัดหน่วยความจำที่ใช้โดยออบเจ็กต์สตริงที่ซ้ำกันในแอปพลิเคชัน Java ซึ่งช่วยลดการใช้หน่วยความจำของออบเจ็กต์สตริงในหน่วยความจำฮีปของ Java โดยการทำให้ค่าสตริงที่ซ้ำกันหรือเหมือนกันใช้อาร์เรย์อักขระเดียวกัน

ตัวประมวลผลข้อความ Apigee Edge เป็นคอมโพเนนต์ที่ใช้ Java การใช้การคัดลอกสตริงในโปรแกรมประมวลผลข้อความช่วยปรับปรุงประสิทธิภาพของพร็อกซี API ด้วยการลดการใช้งานหน่วยความจำ โดยเฉพาะอย่างยิ่งหากพร็อกซี API ใช้งานสตริงเป็นจำนวนมาก

ฟีเจอร์การลดความซ้ำซ้อนของสตริงใช้ได้เฉพาะกับ G1 Garbage Collector (G1GC) ในแอปพลิเคชัน Java หากต้องการเปิดใช้ฟีเจอร์นี้ในตัวประมวลผลข้อความ คุณต้องเปิดใช้ G1GC อยู่แล้ว หรือเปิดใช้ทั้ง G1GC และ String Deduplication ร่วมกันในเครื่องมือประมวลผลข้อความ

ก่อนเริ่มต้น

การเปิดใช้การกรองสตริงซ้ำในตัวประมวลผลข้อความ

ส่วนนี้จะอธิบายวิธีเปิดใช้ฟีเจอร์การลดความซ้ำซ้อนของสตริงในโปรแกรมประมวลผลข้อความ Edge เปิดใช้การทำซ้ำสตริงได้ผ่านพร็อพเพอร์ตี้ useStringDeduplication ในคอมโพเนนต์เครื่องมือประมวลผลข้อความ โดยค่าเริ่มต้น พร็อพเพอร์ตี้นี้จะมีการตั้งค่าเป็น false ในตัวประมวลผลข้อความ หากต้องการกำหนดค่าพร็อพเพอร์ตี้ใดๆ ในตัวประมวลผลข้อความ ให้ใช้โทเค็นตามไวยากรณ์ที่อธิบายไว้ในวิธีกำหนดค่า Edge

หากต้องการเปิดใช้การกรองข้อความที่ซ้ำกันออกจากตัวประมวลผลข้อความ ให้ทำตามขั้นตอนต่อไปนี้

  1. ค้นหาโทเค็นสำหรับพร็อพเพอร์ตี้ useStringDeduplication
  2. เปิดใช้ useStringDeduplication ในตัวประมวลผลข้อความ

ค้นหาโทเค็นสำหรับพร็อพเพอร์ตี้ useStringDeduplication

ขั้นตอนต่อไปนี้อธิบายวิธีค้นหาโทเค็นสำหรับ useStringDeduplication

  1. ค้นหาพร็อพเพอร์ตี้ useStringDeduplication ในไดเรกทอรีต้นทางของตัวประมวลผลข้อความ /opt/apigee/edge-message-processor/source โดยใช้คำสั่งต่อไปนี้ 
    grep -ri "useStringDeduplication" /opt/apigee/edge-message-processor/source
  2. เอาต์พุตของคำสั่งนี้จะแสดงโทเค็นสำหรับพร็อพเพอร์ตี้ useStringDeduplication ของผู้ประมวลผลข้อความ ดังนี้ 
    /opt/apigee/edge-message-processor/source/conf/system.properties:useStringDeduplication={T}conf_system_useStringDeduplication{/T}

    โดยที่สตริงระหว่างแท็ก {T}{/T} คือชื่อของโทเค็นที่คุณตั้งค่าในไฟล์ .properties ของผู้ประมวลผลข้อความได้ ดังนั้น โทเค็นสําหรับพร็อพเพอร์ตี้ useStringDeduplication จะเป็นดังนี้ 

    conf_system_useStringDeduplication

เปิดใช้การกรองข้อความที่ซ้ำกันออกจากตัวประมวลผลข้อความ

ขั้นตอนต่อไปนี้อธิบายวิธีเปิดใช้การทำซ้ำสตริงในเครื่องมือประมวลผลข้อความ Apigee

  1. เปิดไฟล์ /opt/apigee/customer/application/message-processor.properties ในเครื่องโปรแกรมประมวลผลข้อความในตัวแก้ไข หากยังไม่มีไฟล์ ให้สร้างขึ้นมา ตัวอย่างเช่น 
    vi /opt/apigee/customer/application/message-processor.properties
  2. เพิ่มบรรทัดต่อไปนี้ลงในไฟล์นี้ 
    conf_system_useStringDeduplication=true
  3. บันทึกการเปลี่ยนแปลง
  4. ตรวจสอบว่าไฟล์คุณสมบัตินี้เป็นของผู้ใช้ apigee ตัวอย่างเช่น 
    chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
  5. รีสตาร์ทตัวประมวลผลข้อความโดยใช้คำสั่งต่อไปนี้ 
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
  6. ถ้าคุณมีเครื่องมือประมวลผลข้อความมากกว่า 1 รายการ ให้ทำขั้นตอนเหล่านี้ซ้ำในเครื่องมือประมวลผลข้อความทั้งหมด

การยืนยันการคัดลอกสตริงในโปรแกรมประมวลผลข้อความ

ส่วนนี้จะอธิบายวิธียืนยันว่ามีการเปิดใช้การกรองสตริงซ้ำในตัวประมวลผลข้อความสำเร็จแล้ว

แม้ว่าคุณจะใช้โทเค็น conf_system_useStringDeduplication เพื่อเปิดใช้การลดความซ้ำซ้อนของสตริงในโปรแกรมประมวลผลข้อความ แต่คุณจะต้องยืนยันว่าได้ตั้งค่าพร็อพเพอร์ตี้ useStringDeduplication จริงด้วยค่าใหม่ดังนี้

  1. ค้นหาพร็อพเพอร์ตี้ useStringDeduplication ในไดเรกทอรี /opt/apigee/edge-message-processor/conf และตรวจสอบว่าได้ตั้งค่าด้วยค่าใหม่แล้ว ตัวอย่างเช่น 
    grep -ri "useStringDeduplication" /opt/apigee/edge-message-processor/conf
  2. หากเปิดใช้การลดความซ้ำซ้อนของสตริงในตัวประมวลผลข้อความเรียบร้อยแล้ว คำสั่งก่อนหน้าจะแสดงค่าใหม่ในไฟล์ system.properties

    ผลลัพธ์ตัวอย่างจากคำสั่งก่อนหน้าหลังจากที่คุณเปิดใช้การกรองสตริงซ้ำในโปรแกรมประมวลผลข้อความมีดังนี้ 

    /opt/apigee/edge-message-processor/conf/system.properties:useStringDeduplication=true

    ในเอาต์พุตตัวอย่าง โปรดทราบว่ามีการตั้งค่าพร็อพเพอร์ตี้ useStringDeduplication ด้วยค่าใหม่ true ใน system.properties ซึ่งแสดงว่ามีการเปิดใช้การกรองข้อความที่ซ้ำกันออกจากตัวประมวลผลข้อความสำเร็จแล้ว

  3. หากยังเห็นค่าเดิมของพร็อพเพอร์ตี้ useStringDeduplication ให้ตรวจสอบว่าคุณได้ทำตามขั้นตอนทั้งหมดที่ระบุไว้ในการเปิดใช้การกรองข้อความที่ซ้ำกันออกจากตัวประมวลผลข้อความอย่างถูกต้อง หากคุณพลาดขั้นตอนใด ให้ทำซ้ำขั้นตอนทั้งหมดอย่างถูกต้อง
  4. หากยังเปิดใช้การทำซ้ำสตริงไม่ได้ โปรดติดต่อทีมสนับสนุนของ Apigee

สิ่งที่ควรทำถัดไป

เปิดใช้ G1GC ในตัวประมวลผลข้อความ