ความช่วยเหลือ Tableau Server บน Linux

Tableau Server (เวอร์ชัน 2023.3 ขึ้นไป)

ในเดือนตุลาคม ปี 2023 Salesforce ได้เปิดตัวตัวเชื่อมต่อ Data Cloud ใหม่ที่เชื่อมต่อระหว่าง Data Cloud และ Tableau Server ได้อย่างราบรื่น ตัวเชื่อมต่อ Salesforce Data Cloud พร้อมใช้งานแล้วสำหรับ Tableau Cloud, Tableau Desktop และ Tableau Prep ในรุ่นก่อนหน้า

หมายเหตุ: Tableau Server UI จะแสดงทั้งตัวเชื่อมต่อ Customer Data Platform ที่มีอยู่และตัวเชื่อมต่อ Salesforce Data Cloud ใหม่ หลังจากการเลิกใช้ตัวเชื่อมต่อ Customer Data Platform ในเดือนตุลาคม 2023 Tableau Desktop UI จะแสดงตัวเชื่อมต่อ Customer Data Platform (เลิกใช้งาน)

ประโยชน์ของตัวเชื่อมต่อ Salesforce Data Cloud

• ตัวเชื่อมต่อจะรวมอยู่ในการติดตั้ง Tableau Desktop โดยอัตโนมัติ และลดขั้นตอนเพิ่มเติมในการติดตั้งตัวเชื่อมต่อด้วยไฟล์ Taco และไดรเวอร์ JDBC
• ตัวเชื่อมต่อคือพื้นที่เก็บข้อมูลพร้อมด้วยการใช้งานที่ได้รับการปรับปรุง ซึ่งแสดงป้ายกำกับออกเจ็กต์ใน UI การเชื่อมต่อของ Tableau แทนชื่อ API ออกเจ็กต์
• ตัวเชื่อมต่อขับเคลื่อนโดยการค้นหาแบบด่วน

หมายเหตุ: จำเป็นต้องใช้ Tableau Server 2023.3 เพื่อใช้ตัวเชื่อมต่อ Salesforce Data Cloud ปฏิบัติตามขั้นตอนด้านล่างเพื่อตั้งค่าตัวเชื่อมต่อ Tableau Server

ขั้นตอนที่ 1: สร้างแอปที่เชื่อมต่อกับ Salesforce

ตัวเชื่อมต่อ Salesforce Data Cloud ใหม่ยังคงกำหนดให้ลูกค้าสร้างแอปที่เชื่อมต่อของตนเอง ตัวเชื่อมต่อ Salesforce และตัวเชื่อมต่อ Salesforce Data Cloud ใช้แอปที่เชื่อมต่อเดียวกัน หากคุณใช้ตัวเชื่อมต่อ Salesforce อยู่แล้ว คุณจะต้องเพิ่มขอบเขต Customer Data Platform สามขอบเขตที่ระบุไว้ในขั้นตอนที่ 7 ลงในแอปที่เชื่อมต่อที่มีอยู่ของคุณเท่านั้น

1. เข้าสู่ระบบบัญชีนักพัฒนา Salesforce.com และคลิกชื่อผู้ใช้ที่ด้านขวาบน จากนั้นเลือก ตั้งค่า
   
2. ในคอลัมน์การนำทางด้านซ้ายที่อยู่ด้านใต้แอป ให้เลือกตัวจัดการแอป
   
3. ในส่วนแอปที่เชื่อมต่อ ให้คลิกแอปที่เชื่อมต่อใหม่
   
4. ในข้อมูลพื้นฐาน ตั้งชื่อแอป แตะ APIfield เพื่อให้ระบบป้อนข้อมูลโดยอัตโนมัติในรูปแบบที่ถูกต้อง และป้อนอีเมลติดต่อสำหรับแอป
5. ในส่วน API [เปิดใช้งานการตั้งค่า OAuth] ให้เลือกเปิดใช้งานการตั้งค่า OAuth
6. ในการตั้งค่า OAuth ใหม่ที่ปรากฏขึ้น สำหรับ Callback URL ให้ป้อนชื่อโดเมนที่มีคุณสมบัติครบถ้วนของเซิร์ฟเวอร์คุณ โดยใช้โปรโตคอล https และผนวกข้อความต่อไปนี้กับ URL: auth/add_oauth_token
   ตัวอย่าง:
   https://www.your_tableau_server.com/auth/add_oauth_token
7. ย้ายรายการต่อไปนี้จากขอบเขต OAuth ที่ใช้ได้ไปยังขอบเขต OAuth ที่เลือก:
   • เข้าถึงบริการ URL สำหรับข้อมูลประจำตัว (ID, โปรไฟล์, อีเมล, ที่อยู่, โทรศัพท์)
   • จัดการข้อมูลผู้ใช้ผ่าน API (api)
   • ดำเนินการตามคำขอได้ตลอดเวลา (refresh_token, การเข้าถึงแบบออฟไลน์)
   • ทำการค้นหา ANSI SQL บนข้อมูล Customer Data Platform (cdp_query_api)
   • จัดการข้อมูลโปรไฟล์ Customer Data Platform (cdp_profile_api)
   • จัดการข้อมูล API การนำเข้า Customer Data Platform (cdp_ingest_api)
8. คลิกบันทึก

หลังจากที่คุณบันทึกแอป Salesforce จะเติมข้อมูลลงในส่วน API ด้วย ID ต่อไปนี้ที่คุณจะใช้ในการกำหนดค่า Tableau Server ได้แก่

• คีย์ผู้บริโภค
• ข้อมูลลับผู้บริโภค
• Callback URL

  

ขั้นตอนที่ 2: กำหนดค่า Tableau Server สำหรับ Salesforce.com OAuth

เมื่อแอปที่เชื่อมต่อของคุณสร้างขึ้นใน Salesforce รวมถึงว่าคุณมีคีย์ลูกค้า ข้อมูลลับของลูกค้า และ Callback URL คุณจะสามารถกำหนดค่า Tableau Server เพื่อใช้ในการเชื่อมต่อข้อมูลและเอาต์พุตของ Salesforce และ Einstein Discovery ได้

1. ในคอมพิวเตอร์ Tableau Server ที่ข้อความแจ้งคำสั่ง ให้เรียกใช้คำสั่งต่อไปนี้
   tsm configuration set -k oauth.salesforce.client_id -v <your_customer_key>
tsm configuration set -k oauth.salesforce.client_secret -v <your_customer_secret>
tsm configuration set -k oauth.salesforce.redirect_uri -v <your_redirect_URL>
2. (ไม่บังคับ) หากต้องการเปลี่ยนเซิร์ฟเวอร์เริ่มต้นสำหรับเข้าสู่ระบบ ให้ป้อนคำสั่งต่อไปนี้
   tsm configuration set -k oauth.salesforce.server_base_url -v <URL>
3. ป้อนคำสั่งต่อไปนี้เพื่อนำการเปลี่ยนแปลงไปปรับใช้
   tsm pending-changes apply
   หากการเปลี่ยนแปลงที่รอดำเนินการจำเป็นต้องรีสตาร์ทเซิร์ฟเวอร์ คำสั่งใช้การเปลี่ยนแปลงที่รอดำเนินการจะแสดงข้อความแจ้งเพื่อแจ้งให้คุณทราบว่าจะรีสตาร์ท โดยข้อความแจ้งนี้จะปรากฏขึ้นแม้ว่าเซิร์ฟเวอร์จะหยุดทำงาน แต่ในกรณีนี้จะไม่มีการรีสตาร์ท คุณสามารถระงับข้อความแจ้งได้โดยใช้ตัวเลือก --ignore-prompt แต่การดำเนินการนี้จะไม่เปลี่ยนลักษณะการรีสตาร์ท หากการเปลี่ยนแปลงไม่จำเป็นต้องใช้การรีสตาร์ท ระบบจะปรับใช้การเปลี่ยนแปลงนั้นโดยไม่มีข้อความแจ้ง หากต้องการข้อมูลเพิ่มเติม โปรดดู tsm pending-changes apply

กำหนดค่า OAuth แบบกำหนดเองสำหรับไซต์

หากต้องการคำแนะนำในการตั้งค่า โปรดดูหัวข้อการเชื่อมต่อ OAuth

Tableau Server (เวอร์ชัน 2023.1 และก่อนหน้า)

คำเตือน: ตัวเชื่อมต่อ Customer Data Platform จะเลิกใช้งานในเดือนตุลาคม 2023 คุณสามารถใช้ตัวเชื่อมต่อนี้ได้จนกว่าจะเลิกใช้ หลังจากเลิกใช้งานตัวเชื่อมต่อนี้แล้ว ตัวเชื่อมต่อดังกล่าวจะถูกลบออกจากอินเทอร์เฟซผู้ใช้ของ Tableau และแหล่งข้อมูลใดๆ ที่ใช้ตัวเชื่อมต่อดังกล่าวจะไม่ทำงานตามที่คาดไว้อีกต่อไป โดยทั่วไปแล้ว ตัวเชื่อมต่อที่เลิกใช้งานแล้วจะถูกเลิกใช้หลังจากที่เลิกใช้งานแล้ว 1–2 รุ่น

ผู้ใช้ใหม่: หากคุณเป็นผู้ใช้ใหม่ คุณสามารถใช้ตัวเชื่อมต่อ Salesforce Data Cloud ในตัวได้

ส่วนนี้จะอธิบายวิธีเชื่อมต่อจาก Tableau Server ไปยัง Salesforce Customer Data Platform ผ่านการตรวจสอบสิทธิ์แบบ OAuth

ขั้นตอนที่อธิบายในส่วนนี้จำเป็นต้องใช้ข้อมูล Salesforce Customer Data Platform ใน Tableau Server

ขั้นตอนที่ 1: ตั้งค่าตัวเชื่อมต่อ

1. ดาวน์โหลดตัวเชื่อมต่อ Salesforce Customer Data Platform ล่าสุด (ไฟล์ Salesforce_CDP.taco) จากไซต์ตัวเชื่อมต่อ Tableau Exchange
2. ย้ายไฟล์ .taco ไปยังโฟลเดอร์ตัวเชื่อมต่อ Tableau

• Windows: C:\Users[Windows User]\Documents\My Tableau Repository\Connectors
• Linux: /opt/tableau/connectors หรือ /var/opt/tableau_server/data/tabsvc/vizqlserver/Connectors/

3. รีสตาร์ท Tableau Server

ขั้นตอนที่ 2: ติดตั้งไดรเวอร์ JDBC ของ Customer Data Platform

หมายเหตุ: Tableau เวอร์ชัน 2023.1 สำหรับ Server เข้ากันได้กับไดรเวอร์ JDBC เวอร์ชัน 18 ขึ้นไปเท่านั้น

1. ดาวน์โหลดไดรเวอร์ JDBC ล่าสุด (ไฟล์ Salesforce-CDP-jdbc-[version].jar) จากไซต์ GitHub ของ Salesforce CDP: https://github.com/forcedotcom/Salesforce-CDP-jdbc/releases
2. ย้ายไฟล์ Salesforce-CDP-jdbc-[version].jar ที่ดาวน์โหลดไปยังตำแหน่งต่อไปนี้

• Windows: C:\Program Files\Tableau\Drivers
• Linux: /opt/tableau/tableau_driver/jdbc

ขั้นตอนที่ 3: สร้างแอปที่เชื่อมต่อกับ Salesforce

หลังจากที่สร้างขอบเขต API แล้ว ให้ใช้ขั้นตอนต่อไปนี้ในการสร้างแอปที่เชื่อมต่อของ Salesforce เพื่อจัดการกับการมอบหมาย OAuth จาก Tableau Server

1. เข้าสู่ระบบบัญชี Salesforce Customer Data Platform ในฐานะผู้ดูแล คลิกชื่อผู้ใช้ของคุณที่มุมขวาบน จากนั้นเลือกตั้งค่า

   

2. ที่แถบด้านซ้าย ภายใต้ส่วน “แอป” ให้เลือก ตัวจัดการแอป

   

3. ในส่วนแอปที่เชื่อมต่อ ให้คลิกแอปที่เชื่อมต่อใหม่

   

4. ในส่วน ข้อมูลทั่วไป ให้ตั้งชื่อแอปที่เชื่อมต่อ (ตัวอย่างเช่น Example.com) แตะที่ฟิลด์ API เพื่อให้ฟิลด์สร้างรูปแบบที่ถูกต้องเอง และกรอกที่อยู่อีเมลสำหรับติดต่อของแอป

5. ในส่วน API [เปิดใช้งานการตั้งค่า OAuth] ให้เลือก เปิดใช้งานการตั้งค่า OAuth และดำเนินการต่อไปนี้:

   1. ในการตั้งค่า OAuth ใหม่ที่ปรากฏขึ้น สำหรับ Callback URL ให้พิมพ์ชื่อโดเมนที่มีคุณสมบัติครบถ้วน (FQDN) ของ Tableau Server ของคุณโดยใช้โปรโตคอล https และเพิ่มข้อความต่อไปนี้ต่อท้าย URL: /auth/add_oauth_token

      ตัวอย่าง: https://example.com/auth/add_oauth_token

      

   2. ย้ายรายการต่อไปนี้จากขอบเขต OAuth ที่ใช้ได้ไปยังขอบเขต OAuth ที่เลือก:

      • จัดการข้อมูลผู้ใช้ผ่าน API (api)
      • ดำเนินคำขอในนามของคุณได้ทุกเวลา (refresh_token, offline_access)
      • จัดการข้อมูลโปรไฟล์ Customer Data Cloud (cdp_profile_api)
      • ทำการค้นหา ANSI SQL บนข้อมูล Customer Data Platform (cdp_query_api)

      

6. เมื่อเสร็จแล้ว ให้คลิกบันทึก

7. ไปที่รายการ ตัวจัดการแอป และไปที่แอปที่เชื่อมต่อของคุณ คลิกที่ลูกศรเมนูดรอปดาวน์และเลือก จัดการ

   

หลังจากที่บันทึกแอปแล้ว จะมีการป้อนข้อมูล ID ต่อไปนี้ในส่วน API (เปิดใช้งานการตั้งค่า OAuth) ซึ่งคุณจะใช้ในการกำหนดค่า Tableau Server

• คีย์ผู้บริโภค
• ข้อมูลลับผู้บริโภค
• Callback URL

  หมายเหตุ: บันทึกคีย์ผู้บริโภค ข้อมูลลับ และ URL การเรียกกลับของคุณเพื่อใช้ในภายหลัง

  
  
  

ใช้ OAuth กับ Customer Data Platform

โปรดพิจารณาการกำหนดค่าไคลเอ็นต์ OAuth แบบกำหนดเองให้เป็น 1) เขียนทับไคลเอนต์ OAuth หากกำหนดค่าให้กับเซิร์ฟเวอร์ หรือ 2) เปิดใช้งานการสนับสนุนเพื่อการเชื่อมต่อกับข้อมูลที่จำเป็นต้องมีไคลเอ็นต์ OAuth ที่ไม่ซ้ำกันอย่างปลอดภัย

หลังจากที่สร้างแอปที่เชื่อมต่อแล้วใน Salesforce และคุณมีคีย์ผู้บริโภค ข้อมูลลับผู้บริโภค และ URL การเรียกกลับแล้ว คุณสามารถกำหนดค่า Tableau Server สำหรับการเชื่อมต่อ OAuth ของ Customer Data Platform ได้ ในการเริ่มต้น ให้รวบรวมข้อมูลต่อไปนี้

• คีย์ผู้บริโภค: คีย์ผู้บริโภค หรือที่รู้จักกันในชื่อ ID ลูกค้าใน Tableau นั้นสร้างจากขั้นตอนสุดท้ายของขั้นตอนที่ 4 ใช้ค่านี้สำหรับ [your_consumer_key] ในคำสั่ง tsm ต่อไปนี้
• ข้อมูลลับผู้บริโภค: ข้อมูลลับผู้บริโภค หรือที่รู้จักกันในชื่อข้อมูลลับของลูกค้าใน Tableau นั้นสร้างจากขั้นตอนสุดท้ายของขั้นตอนที่ 4 ใช้ค่านี้สำหรับ [your_consumer_secret] ในคำสั่ง tsm ต่อไปนี้
• Callback URL: Callback URL หรือที่รู้จักกันในชื่อ URL ที่เปลี่ยนเส้นทางใน Tableau คือ URL ของ Tableau Server ของคุณ https://example.com และต่อท้ายด้วย "/auth/add_oauth_token" ใช้ค่านี้สำหรับ [your_callback_url] ในคำสั่ง tsm ต่อไปนี้
• ID การกำหนดค่า: ค่าของพารามิเตอร์ oauth.config.id ที่คุณใช้ใน tsm ต่อไปนี้: customer_360_audience

ใช้คำสั่ง TSM สำหรับการตั้งค่า OAuth

เรียกใช้คำสั่ง tsm ต่อไปนี้เพื่อกำหนดค่า OAuth

tsm configuration set -k oauth.config.clients -v "[{\"oauth.config.id\":\"customer_360_audience\", \"oauth.config.client_id\":\"[your_consumer_key]\", \"oauth.config.client_secret\":\"[your_consumer_secret]\", \"oauth.config.redirect_uri\":\"[your_callback_url]\"}]" --force-keys

tsm pending-changes apply

การตั้งค่าตัวเชื่อมต่อหลายตัว

หากมีตัวเชื่อมต่อหลายตัวที่จะตั้งค่า คุณต้องรวมตัวเชื่อมต่อทั้งหมดไว้ในคำสั่งเดียว ตัวอย่าง: 

tsm configuration set -k oauth.config.clients -v "[{\"oauth.config.id\":\"custom_360_audience\", \"oauth.config.client_id\":\"[your_consumer_key]\", \"oauth.config.client_secret\":\"[your_consumer_secret]\", \"oauth.config.redirect_uri\":\"[your_callback_url]\"}, {\"oauth.config.id\":\"dremio\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}, {\"oauth.config.id\":\"azure_sql_dw\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}, {\"oauth.config.id\":\"azure_sqldb\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}]" --force-keys

tsm pending-changes apply

ขั้นตอนที่ 1: ลงทะเบียน ID ไคลเอ็นต์ OAuth และข้อมูลลับของไคลเอ็นต์

ดำเนินการตามขั้นตอนต่อไปนี้ให้เสร็จสิ้นเพื่อลงทะเบียนไคลเอ็นต์ OAuth ที่กำหนดเองไปยังไซต์ของคุณ

1. เข้าสู่ระบบ Tableau Server โดยใช้ข้อมูลเข้าสู่ระบบของผู้ดูแลไซต์และไปที่หน้าการตั้งค่า
2. ภายใต้รีจิสทรีไคลเอ็นต์ OAuth ให้เลือกปุ่มเพิ่มไคลเอ็นต์ OAuth
3. สำหรับประเภทการเชื่อมต่อ ให้เลือก Customer Data Platform
4. สำหรับผู้ให้บริการ OAuth ให้เลือก IDP ที่กำหนดเอง
5. ป้อน ID ไคลเอ็นต์
6. ป้อนข้อมูลลับไคลเอ็นต์
7. ป้อน URL การเปลี่ยนเส้นทาง
8. สำหรับ “เลือกไฟล์กำหนดค่า OAuth” ให้เลือกปุ่มเลือกไฟล์เพื่ออัปโหลดไฟล์การกำหนดค่า
9. เลือกปุ่มเพิ่มไคลเอ็นต์ OAuth เพื่อดำเนินการตามขั้นตอนการลงทะเบียนให้เสร็จสิ้น
10. เลือกปุ่ม “บันทึก” ที่ด้านล่างหรือด้านบนของหน้า “การตั้งค่า” เพื่อบันทึกการเปลี่ยนแปลง

ขั้นตอนที่ 2: ยืนยันความถูกต้องและอัปเดตข้อมูลเข้าสู่ระบบที่บันทึกไว้

เพื่อให้แน่ใจว่าการเข้าถึงข้อมูลจะไม่ถูกรบกวน คุณ (และผู้ใช้ไซต์ของคุณ) จะต้องลบข้อมูลเข้าสู่ระบบที่บันทึกไว้ก่อนหน้าและเพิ่มข้อมูลเข้าสู่ระบบดังกล่าวอีกครั้ง

1. ไปยังหน้า “การตั้งค่าบัญชีของฉัน”
2. ภายใต้ข้อมูลเข้าสู่ระบบที่บันทึกไว้สำหรับแหล่งข้อมูล เลือกลบถัดจากข้อมูลเข้าสู่ระบบที่บันทึกไว้ที่มีอยู่
3. ถัดจากตัวเชื่อมต่อเดียวกัน ให้เลือกเพิ่ม
4. ปฏิบัติตามข้อความแจ้งเพื่อเชื่อมต่อกับตัวเชื่อมต่อ Customer Data Platform
5. เลือกบันทึก

ขั้นตอนที่ 3: แจ้งเตือนผู้ใช้เพื่ออัปเดตข้อมูลเข้าสู่ระบบที่บันทึกไว้

ตรวจสอบว่าคุณแจ้งให้ผู้ใช้ไซต์ของคุณอัปเดตข้อมูลเข้าสู่ระบบที่บันทึกไว้สำหรับตัวเชื่อมต่อ Customer Data Platform ผู้ใช้ไซต์สามารถใช้ขั้นตอนที่อธิบายไว้ใน “จัดการข้อมูลเข้าสู่ระบบที่บันทึกไว้สำหรับการเชื่อมต่อข้อมูล” เพื่ออัปเดตข้อมูลเข้าสู่ระบบที่บันทึกไว้

ดูเพิ่มเติม

• ความช่วยเหลือของ Salesforce: ตั้งค่า Tableau ใน Customer Data Platform
• ความช่วยเหลือของ Salesforce: เปิดใช้งาน Customer Data Platform ใน Tableau
• ความช่วยเหลือของ Salesforce: การใช้ข้อมูลของ Customer Data Platform ใน Tableau