หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
Note
การรวม Fabric Connection กับสมุดบันทึกอยู่ในการแสดงตัวอย่าง
การผสานรวมกับ Fabric Connection ช่วยให้คุณใช้แหล่งข้อมูลภายนอกได้โดยตรงจากสมุดบันทึก คุณสามารถนําการเชื่อมต่อและข้อมูลประจําตัวที่มีอยู่กลับมาใช้ใหม่ได้ ซึ่งทําให้ง่ายต่อการทํางานกับแหล่งข้อมูลต่างๆ และมอบประสบการณ์การเขียนโค้ดที่ราบรื่นภายในสมุดบันทึก
เมื่อต้องการใช้การเชื่อมต่อ Fabric ในสมุดบันทึก คุณต้องเปิดใช้งานการเชื่อมต่ออย่างชัดเจนเพื่อใช้ในสมุดบันทึกจากหน้า การจัดการแหล่งข้อมูล Fabric มีกล่องกาเครื่องหมายเฉพาะเพื่อเปิดใช้งานการเชื่อมต่อที่จะใช้ในสมุดบันทึกที่เรียกว่า อนุญาตให้ Code-First Artifacts เช่นสมุดบันทึก access การเชื่อมต่อนี้ (ตัวอย่าง) ช่องทําเครื่องหมายนี้สามารถตั้งค่าได้ในระหว่างการสร้างเท่านั้น และไม่สามารถแก้ไขได้ในภายหลัง
ต่อไปนี้เป็นวิธีการรับรองความถูกต้องที่รองรับสําหรับการเชื่อมต่อ Fabric ในสมุดบันทึก:
- การรับรองความถูกต้องขั้นพื้นฐาน: รองรับฐานข้อมูล Azure SQL Database และฐานข้อมูลอื่นๆ ที่รองรับการรับรองความถูกต้องขั้นพื้นฐาน
- การรับรองความถูกต้องของคีย์บัญชี: รองรับแหล่งข้อมูล REST API ที่ต้องมีการรับรองความถูกต้องของคีย์บัญชี
- การรับรองความถูกต้องของโทเค็น: รองรับแหล่งข้อมูลที่ต้องมีการรับรองความถูกต้องตามโทเค็น
- การรับรองความถูกต้องของข้อมูลประจําตัวพื้นที่ทํางาน: รองรับการรับรองความถูกต้องของข้อมูลประจําตัวพื้นที่ทํางาน Fabric
- การรับรองความถูกต้องของบริการหลัก (SPN): รองรับแหล่งข้อมูลที่ต้องมีการรับรองความถูกต้องตาม SPN
สําคัญ
OAuth2.0 ไม่ได้รับการสนับสนุนสําหรับการเชื่อมต่อแฟบริคในสมุดบันทึก หากคุณเลือกการรับรองความถูกต้องของข้อมูลประจําตัวพื้นที่ทํางานหรือ SPN ตรวจสอบให้แน่ใจว่าได้ให้สิทธิ์ที่จําเป็นแก่ข้อมูลประจําตัวพื้นที่ทํางาน Fabric เพื่อ access แหล่งข้อมูล สําหรับข้อมูลการตั้งค่าโดยละเอียดสําหรับตัวเชื่อมต่อแต่ละตัว โปรดดู การจัดการแหล่งข้อมูล
มีการตั้งค่าระดับผู้เช่าที่อนุญาตให้ผู้ดูแลระบบผู้เช่าสามารถควบคุมได้ว่ามีการเปิดใช้งานคุณลักษณะนี้สําหรับผู้เช่าทั้งหมดหรือไม่ หากการตั้งค่าถูกปิดใช้งาน ผู้ใช้จะไม่สามารถใช้ Fabric Connection ในสมุดบันทึกได้ ตามค่าเริ่มต้น คุณลักษณะนี้จะไม่เปิดใช้งาน
วิธีสร้าง Fabric Connection สําหรับโน้ตบุ๊ก
มีสองวิธีในการสร้าง Fabric Connection สําหรับโน้ตบุ๊ก
โน้ตบุ๊กจะใช้บานหน้าต่าง Connections แทนโมดูล get data ที่มีในประสบการณ์ Fabric อื่น ๆ ใช้โหนดของมันเพื่อค้นหาการเชื่อมต่อ:
- สมุดบันทึกปัจจุบัน: ดูการเชื่อมต่อที่ผูกกับสมุดบันทึกที่เปิดอยู่
- สิทธิ์ทั่วโลก: ดูการเชื่อมต่อพื้นที่ทํางานที่คุณสามารถผูกกับสมุดบันทึกได้
เลือก เพิ่มการเชื่อมต่อ เพื่อสร้างและผูกการเชื่อมต่อจากภายในสมุดบันทึก
สร้างการเชื่อมต่อ Fabric ภายในสมุดบันทึก
ภายในสมุดบันทึก คุณสามารถสร้างการเชื่อมต่อ Fabric ได้โดยเลือก เพิ่มการเชื่อมต่อ ในบานหน้าต่าง การเชื่อมต่อ
ซึ่งจะเปิดบานหน้าต่าง เพิ่มการเชื่อมต่อ ซึ่งคุณสามารถเลือกชนิดแหล่งข้อมูลได้ ระบุรายละเอียดการเชื่อมต่อและเลือกวิธีการรับรองความถูกต้อง
สําหรับการเชื่อมต่อที่สร้างขึ้นภายในสมุดบันทึก กล่องกาเครื่องหมาย อนุญาตให้ Code-First Artifacts เช่น สมุดบันทึก access การเชื่อมต่อนี้ (ตัวอย่าง) จะถูกเลือกไว้ตามค่าเริ่มต้น หลังจากสร้างการเชื่อมต่อแล้ว การเชื่อมต่อจะถูกผูกไว้กับสมุดบันทึกปัจจุบันโดยอัตโนมัติ และจะปรากฏในโหนด สมุดบันทึกปัจจุบัน ในบานหน้าต่าง การเชื่อมต่อ
สร้างการเชื่อมต่อ Fabric จากหน้า การจัดการแหล่งข้อมูล
คุณสามารถสร้างการเชื่อมต่อแฟบริคได้จากหน้าการจัดการแหล่งข้อมูลที่มีอยู่ To do นี้ ให้ไปที่หน้า การจัดการแหล่งข้อมูล แล้วเลือก ใหม่ คุณสามารถค้นหารายละเอียดเพิ่มเติมเกี่ยวกับวิธีการสร้างการเชื่อมต่อ Fabric ได้จากหน้า การจัดการแหล่งข้อมูล ใน การจัดการแหล่งข้อมูล
เมื่อสร้างการเชื่อมต่อ ตรวจสอบให้แน่ใจว่าได้เลือกกล่องกาเครื่องหมาย อนุญาตให้ Code-First Artifacts เช่น สมุดบันทึก access การเชื่อมต่อนี้ (แสดงตัวอย่าง) เพื่อให้สามารถใช้การเชื่อมต่อในสมุดบันทึกได้ การตั้งค่านี้สามารถกําหนดค่าได้ในระหว่างการสร้างเท่านั้น และไม่สามารถเปลี่ยนแปลงได้ในภายหลัง
หลังจากสร้างการเชื่อมต่อแล้ว จะปรากฏในโหนด สิทธิ์ส่วนกลาง ในบานหน้าต่าง การเชื่อมต่อ ภายในสมุดบันทึก
สําหรับการเชื่อมต่อภายใต้โหนด สิทธิ์ส่วนกลาง คุณต้องผูกการเชื่อมต่อกับสมุดบันทึกปัจจุบันอย่างชัดเจนโดยเลือก เชื่อมต่อ ในเมนูบริบทการเชื่อมต่อ
หลังจากที่คุณผูกการเชื่อมต่อกับสมุดบันทึกปัจจุบัน จะปรากฏในโหนด สมุดบันทึกปัจจุบัน ในบานหน้าต่าง การเชื่อมต่อ
สถานะการเชื่อมต่อ
เมื่อเวลาผ่านไป สถานะของการเชื่อมต่อ Fabric อาจเปลี่ยนแปลงได้ด้วยเหตุผลต่าง ๆ เช่น การหมดอายุของข้อมูลรับรองหรือการเปลี่ยนแปลงสิทธิ์ คุณสามารถตรวจสอบสถานะการเชื่อมต่อได้โดยเลือกปุ่ม ตรวจสอบสถานะ จากเมนูบริบท
หากมีปัญหาใดๆ กับการเชื่อมต่อ ไอคอนออฟไลน์จะแสดงถัดจากชื่อการเชื่อมต่อ ต่อไปนี้เป็นสถานการณ์ทั่วไปที่อาจทําให้การเชื่อมต่อออฟไลน์:
- การหมดอายุของข้อมูลประจําตัว: หากข้อมูลเข้าสู่ระบบที่ใช้สําหรับการเชื่อมต่อหมดอายุ การเชื่อมต่อจะออฟไลน์ คุณต้องอัปเดตข้อมูลประจําตัวเพื่อนําการเชื่อมต่อกลับมาออนไลน์
- การเปลี่ยนแปลงสิทธิ์: หากสิทธิ์สําหรับแหล่งข้อมูลมีการเปลี่ยนแปลงและการเชื่อมต่อไม่มี access อีกต่อไป คุณต้องคืนค่าสิทธิ์ที่จําเป็นเพื่อนําการเชื่อมต่อกลับมาออนไลน์ ตัวอย่างเช่น หากคุณกําลังใช้การรับรองความถูกต้องของข้อมูลประจําตัวพื้นที่ทํางานหรือ SPN ตรวจสอบให้แน่ใจว่าข้อมูลประจําตัวพื้นที่ทํางานแบบ Fabric หรือ SPN มีสิทธิ์ที่จําเป็นในการ access แหล่งข้อมูล
- ปัญหาเครือข่าย: หากมีปัญหาเครือข่ายที่ทําให้ไม่สามารถ access ไปยังแหล่งข้อมูล คุณต้องแก้ไขปัญหาเครือข่ายเพื่อนําการเชื่อมต่อกลับมาออนไลน์
- ลบการเชื่อมต่อ: หากการเชื่อมต่อถูกลบหลังจากผูกกับสมุดบันทึก การเชื่อมต่อจะออฟไลน์โดยมีข้อผิดพลาดไม่พร้อมใช้งาน คุณไม่สามารถสร้างส่วนย่อยของโค้ดจากการเชื่อมต่อแบบออฟไลน์ได้
สําหรับการเชื่อมต่อแบบออฟไลน์ภายใต้โหนด "สมุดบันทึกปัจจุบัน" ตัวเลือก "ตรวจสอบสถานะ" และ "ยกเลิกการเชื่อมต่อ" จะพร้อมใช้งานในเมนูบริบท คุณไม่สามารถสร้างส่วนย่อยของโค้ดจากการเชื่อมต่อแบบออฟไลน์ได้ หาก สถานะการตรวจสอบ ถูกปิดใช้งานด้วย แสดงว่าการเชื่อมต่อถูกลบ คุณสามารถสร้างการเชื่อมต่อใหม่และผูกกับสมุดบันทึกอีกครั้ง หรืออัปเดตส่วนย่อยของโค้ดเพื่อใช้การเชื่อมต่ออื่นที่พร้อมใช้งาน
สําหรับการเชื่อมต่อแบบออฟไลน์ภายใต้โหนด "สิทธิ์ส่วนกลาง" ตัวเลือก "ตรวจสอบสถานะ" จะพร้อมใช้งานในเมนูบริบท คุณไม่สามารถเชื่อมต่อการเชื่อมต่อแบบออฟไลน์กับสมุดบันทึกปัจจุบันได้ ตัวเลือก "ลบ" จะใช้ได้ก็ต่อเมื่อผู้ใช้ปัจจุบันมีสิทธิ์ของเจ้าของสําหรับการเชื่อมต่อ
สําคัญ
ถ้าใช้การรับรองความถูกต้องของข้อมูลประจําตัวพื้นที่ทํางานเพื่อสร้างการเชื่อมต่อ ตัวเลือก ตรวจสอบสถานะ จะไม่สามารถตรวจสอบได้ว่าการเชื่อมต่อเป็นแบบออนไลน์หรือออฟไลน์ เนื่องจากการเชื่อมต่อทดสอบไม่สนับสนุนการรับรองความถูกต้องของข้อมูลประจําตัวพื้นที่ทํางาน
วิธีใช้ Fabric Connection ในโค้ดโน้ตบุ๊ก
หลังจากที่คุณสร้าง Fabric Connection และผูกกับโน้ตบุ๊กปัจจุบันแล้ว คุณสามารถสร้างโค้ดสคริปต์เพื่อเข้าถึงแหล่งข้อมูลโดยตรงจากโน้ตบุ๊ก
ค้นหาการเชื่อมต่อในโหนด "สมุดบันทึกปัจจุบัน"
เลือกจุดไข่ปลา (...) จากนั้นเลือก "เพิ่มเป็นเซลล์โค้ด" จากเมนูบริบท
รหัสจะได้รับรายละเอียดข้อมูลประจําตัวของการเชื่อมต่อ ใช้ข้อมูลประจําตัวเหล่านั้นเพื่อตั้งค่าไคลเอ็นต์สําหรับแหล่งข้อมูล จากนั้นเรียกใช้คิวรีเพื่อรับข้อมูล คุณสามารถปรับข้อมูลโค้ดที่สร้างขึ้นให้เหมาะกับความต้องการในการสืบค้นของคุณได้ ถ้าแพคเกจที่จําเป็นไม่มีอยู่ในรันไทม์ เซลล์โค้ดก่อนหน้าที่มีคําสั่ง pip install จะปรากฏขึ้น ให้เรียกใช้เซลล์นั้นก่อนเรียกใช้คิวรี
ต่อไปนี้เป็นตัวอย่างของส่วนย่อยของโค้ดที่สร้างขึ้นสําหรับการเชื่อมต่อ Azure Cosmos DB:
from azure.cosmos import CosmosClient
import json
import pandas as pd
connection_id = '9d405da3-3d11-481a-9022-xxxxxxxxxxx' # connection name: "neweventdb qixwang"
connection_credential = notebookutils.connections.getCredential(connection_id)
credential_dict = json.loads(connection_credential['credential'])
key = next(item['value'] for item in credential_dict['credentialData'] if item['name'] == 'key')
endpoint = 'https://userevent.documents.azure.com:443/'
client = CosmosClient(endpoint, credential=key)
databases = list(client.list_databases())
database = databases[0]
database_client = client.get_database_client(database['id'])
containers = list(database_client.list_containers())
container = containers[0]
container_name = container['id']
container_client = database_client.get_container_client(container_name)
query = f"SELECT * FROM {container_name} p"
items = list(container_client.query_items(query=query, enable_cross_partition_query=True))
df = pd.DataFrame(items)
display(df)
เรียกใช้เซลล์โค้ดด้วย pip install คําสั่งก่อนเพื่อติดตั้งแพคเกจที่จําเป็น จากนั้นเรียกใช้เซลล์โค้ดเพื่อรับข้อมูลจากแหล่งข้อมูล
ข้อกําหนดสิทธิ์การเชื่อมต่อ
เมื่อคุณเรียกใช้สมุดบันทึก การตรวจสอบสิทธิ์จะทําให้แน่ใจว่าคุณมีสิทธิ์ที่จําเป็นในการใช้การเชื่อมต่อ ถ้าคุณไม่มีสิทธิ์ สมุดบันทึกจะแสดงข้อความแสดงข้อผิดพลาด
ถ้าคุณแชร์สมุดบันทึกกับผู้ใช้รายอื่น พวกเขายังต้องมีสิทธิ์ที่ถูกต้องเพื่อใช้การเชื่อมต่อและเรียกใช้เซลล์โค้ด เรียนรู้เพิ่มเติมเกี่ยวกับการจัดการสิทธิ์การเชื่อมต่อในการจัดการแหล่งข้อมูล
หากมีการใช้การรับรองความถูกต้องของข้อมูลประจําตัวพื้นที่ทํางานหรือ SPN สําหรับการเชื่อมต่อ ตรวจสอบให้แน่ใจว่าข้อมูลประจําตัวพื้นที่ทํางาน Fabric หรือ SPN มีสิทธิ์ที่จําเป็นในการ access แหล่งข้อมูล
สําหรับการเชื่อมต่อ Azure Key Vault ข้อกําหนดสิทธิ์ต่อไปนี้จะนําไปใช้หากมีการใช้การรับรองความถูกต้องของ SPN หรือข้อมูลประจําตัวพื้นที่ทํางาน:
- ข้อมูลประจําตัวพื้นที่ทํางาน SPN หรือ Fabric ต้องมีบทบาท Admin/Contributor บน Key Vault เพื่อ access ข้อมูลลับ
- ข้อมูลประจําตัวพื้นที่ทํางาน SPN หรือ Fabric ต้องมีบทบาท Azure Resource Owner/Contributor บน Key Vault
- อัปเดตนโยบาย access ใน Key Vault เพื่อให้สิทธิ์ secret access ไปยังข้อมูลประจําตัวของพื้นที่ทํางาน SPN หรือ Fabric
- เปิดใช้งาน "Vault access policy" ในนโยบาย access ของ Key Vault และให้สิทธิ์ "Get" และ "List" สําหรับข้อมูลลับของข้อมูลประจําตัวพื้นที่ทํางาน SPN หรือ Fabric
เชื่อมต่อหรือยกเลิกการเชื่อมต่อ Fabric จากโน้ตบุ๊ก
ในการเชื่อมต่อหรือยกเลิกการเชื่อมต่อ Fabric จากโน้ตบุ๊กปัจจุบัน:
- เลือกการเชื่อมต่อในโหนด "สมุดบันทึกปัจจุบัน"
- เลือกจุดไข่ปลา (...) แล้วเลือก "ยกเลิกการเชื่อมต่อ" หรือ "เชื่อมต่อ" จากเมนูบริบท
หากการเชื่อมต่อเดียวกันถูกตัดการเชื่อมต่อและเชื่อมต่อใหม่ ID การเชื่อมต่อจะเปลี่ยนไป สําหรับเซลล์โค้ดที่มีอยู่ซึ่งอ้างอิงการเชื่อมต่อ คุณจําเป็นต้องอัปเดตรหัสการเชื่อมต่อในเซลล์รหัสเป็นรหัสการเชื่อมต่อใหม่ คุณสามารถค้นหา ID การเชื่อมต่อในเมนูบริบทของการเชื่อมต่อโดยเลือก คัดลอก ID
ปัญหาที่ทราบและข้อจํากัด
- การรับรองความถูกต้อง OAuth2.0 ไม่ได้รับการสนับสนุนสําหรับการเชื่อมต่อแฟบริกในสมุดบันทึก