สํารวจเหตุการณ์ที่เก็บข้อมูล Azure blob ในฮับ Real-Time Fabric (ตัวอย่าง)
บทความนี้แสดงวิธีการสํารวจเหตุการณ์ที่เก็บข้อมูล Azure blob ในฮับเวลาจริงของ Fabric เหตุการณ์ที่เก็บข้อมูล Azure blob ช่วยให้คุณสามารถรับการแจ้งเตือนเมื่อมีการดําเนินการบางอย่างเกิดขึ้นบน blobs ของคุณ ตัวอย่างเช่น คุณสามารถรับการแจ้งเตือนเมื่อมีการสร้าง blob ใหม่ หรือ blob ที่มีอยู่ถูกปรับเปลี่ยน เหตุการณ์เหล่านี้สามารถใช้เพื่อตั้งค่าการแจ้งเตือนเกี่ยวกับการดําเนินการหรือเวิร์กโฟลว์อื่น ๆ เช่น การอัปเดตฐานข้อมูล หรือการส่งการแจ้งเตือน บทความนี้มีคุณสมบัติและ schema สําหรับเหตุการณ์ที่เก็บข้อมูล Azure blob
หมายเหตุ
เหตุการณ์ Fabric และ Azure ที่ใช้ผ่านเหตุการณ์เหตุการณ์หรือ Fabric Activator ไม่ได้รับการสนับสนุนหากพื้นที่ความจุของเหตุการณ์หรือตัวกระตุ้นอยู่ในภูมิภาคต่อไปนี้: อินเดียตะวันตก อิสราเอลกลาง เกาหลีกลาง Qatar Central, สิงคโปร์, UAE Central, สเปนกลาง, บราซิลตะวันออกเฉียงใต้, สหรัฐอเมริกากลาง, สหรัฐอเมริกาตอนกลางทางใต้, สหรัฐอเมริกาตะวันตก 2, สหรัฐอเมริกาตะวันตก 3
ดูหน้ารายละเอียดเหตุการณ์ที่เก็บข้อมูล Blob ของ Azure
ใน ฮับแบบเรียลไทม์ เลือก เหตุการณ์ Azure บนเมนูนําทางด้านซ้าย
เลือก เหตุการณ์ ที่เก็บข้อมูล Azure blob ในรายการ
คุณควรเห็นหน้ารายละเอียดเหตุการณ์ที่เก็บข้อมูล Blob ของ Azure
การดำเนินการ
ที่ด้านบนของหน้ารายละเอียดเหตุการณ์ที่เก็บข้อมูล Blob ของ Azure คุณจะเห็นการดําเนินการสองต่อไปนี้
สร้างเหตุการณ์สตรีม - ช่วยให้คุณสร้างเหตุการณ์ตามเหตุการณ์จากที่เก็บข้อมูล Azure blob ที่เลือก
ตั้งค่าการแจ้งเตือน - ช่วยให้คุณตั้งค่าการแจ้งเตือนเมื่อการดําเนินการเสร็จสิ้นบนวัตถุที่เก็บข้อมูล Azure blob ตัวอย่างเช่น คุณสามารถตั้งค่าการแจ้งเตือนเมื่อมีการสร้างหรือลบ blob
ดูว่าอะไรกําลังใช้ประเภทนี้อยู่บ้าง
ส่วนนี้แสดงอาร์ติแฟกต์โดยใช้เหตุการณ์ Azure Blob Storage ต่อไปนี้คือคอลัมน์และคําอธิบายที่แสดงในรายการ
คอลัมน์ | รายละเอียด |
---|---|
ชื่อ | ชื่อของวัตถุที่ใช้เหตุการณ์ Azure Blob Storage |
ขนิด | ชนิดอาร์ติแฟกต์ – Activator หรือ Eventstream |
พื้นที่ทำงาน | พื้นที่ทํางานที่วัตถุอยู่ |
แหล่งที่มา | ชื่อของแหล่งข้อมูล (บัญชี Azure Blob Storage) |
โปรไฟล์เหตุการณ์ที่เก็บข้อมูล Blob ของ Azure
ชนิดของเหตุการณ์
ชื่อชนิดเหตุการณ์ | รายละเอียด |
---|---|
Microsoft.Storage.BlobCreated | เหตุการณ์นี้จะถูกเรียกใช้เมื่อมีการเพิ่ม blob ใหม่ หรือเมื่อมีการอัปเดต blob ที่มีอยู่ เหตุการณ์ถูกทริกเกอร์ โดยไคลเอ็นต์ที่ใช้CreateFile การดําเนินการ และ FlushWithClose ซึ่งสามารถพบได้ใน Azure Data Lake Storage รุ่น2 REST API |
Microsoft.Storage.BlobDeleted | เหตุการณ์นี้จะถูกเรียกใช้เมื่อลบ blob จะถูกทริกเกอร์เมื่อไคลเอ็นต์ใช้DeleteFile การดําเนินการที่สามารถพบได้ใน Azure Data Lake Storage รุ่น2 REST API |
Microsoft.Storage.BlobRenamed | เหตุการณ์นี้จะถูกเปิดใช้งานเมื่อ blob ผ่านการเปลี่ยนชื่อ โดยเฉพาะอย่างยิ่งเมื่อผู้ใช้ใช้RenameFile ฟังก์ชันที่พบใน Azure Data Lake Storage รุ่น2 REST API |
Microsoft.Storage.BlobTierChanged | เหตุการณ์นี้จะถูกเปิดใช้งานเมื่อระดับการเข้าถึง blob ถูกปรับเปลี่ยนผ่าน SetBlobTier การดําเนินการใน Blob REST API และถูกทริกเกอร์เมื่อการเปลี่ยนแปลงจะประมวลผลทั้งหมด |
Microsoft.Storage.AsyncOperationInitiated | เหตุการณ์นี้เกิดขึ้นเมื่อข้อมูลถูกย้ายหรือคัดลอกจากที่เก็บถาวรไปยังระดับร้อนหรือเย็น ซึ่งเกิดขึ้นเมื่อไคลเอ็นต์ใช้ SetBlobTier API เพื่อย้าย blob จากที่เก็บถาวรไปยังระดับร้อน หรือเย็น หรือเมื่อไคลเอ็นต์ใช้ CopyBlob API เพื่อคัดลอกข้อมูลจากระดับเก็บถาวร blob ไปยัง blob ระดับร้อน หรือเย็น |
Microsoft.Storage.Directory สร้าง | เหตุการณ์นี้ถูกเปิดใช้งานเมื่อสร้างไดเรกทอรีใหม่ หรือไคลเอ็นต์ใช้CreateDirectory การดําเนินการที่ระบุไว้ใน Azure Data Lake Storage รุ่น2 REST API เพื่อสร้างไดเรกทอรีใหม่ |
Microsoft.Storage.DirectoryRenamed | ระบบจะเปิดใช้งานเหตุการณ์นี้เมื่อไดเรกทอรีมีการเปลี่ยนชื่อ โดยเฉพาะอย่างยิ่งเมื่อไคลเอ็นต์ใช้คุณลักษณะ RenameDirectory ใน Azure Data Lake Storage รุ่น2 REST API |
Microsoft.Storage.DirectoryDeleted | เหตุการณ์นี้จะถูกเปิดใช้งานเมื่อลบไดเรกทอรีเมื่อลูกค้าใช้DeleteDirectory คุณลักษณะที่มีอยู่ใน Azure Data Lake Storage รุ่น2 REST API |
Microsoft.Storage.BlobInventoryPolicyCompleted | ระบบจะเรียกใช้เหตุการณ์นี้เมื่อการรันสินค้าคงคลังเสร็จสิ้นสําหรับนโยบายที่ระบุเป็นนโยบายสินค้าคงคลัง นอกจากนี้ยังเปิดใช้งานหากการเรียกใช้สินค้าคงคลังล้มเหลวเนื่องจากข้อผิดพลาดของผู้ใช้ก่อนที่จะเริ่มเช่นนโยบายที่มีข้อผิดพลาดหรือคอนเทนเนอร์ปลายทางที่ขาด |
Microsoft.Storage.LifecyclePolicyCompleted | เหตุการณ์นี้อ้างอิงถึงการเปิดใช้งานของนโยบายการจัดการวงจรชีวิตเมื่อการดําเนินการที่กําหนดไว้ถูกดําเนินการ |
Schemas
เหตุการณ์มีข้อมูลระดับบนสุดต่อไปนี้:
คุณสมบัติ | ขนิด | รายละเอียด | ตัวอย่างเช่น |
---|---|---|---|
source |
string | เส้นทางทรัพยากรแบบเต็มไปยังแหล่งข้อมูลเหตุการณ์ เขตข้อมูลนี้ไม่สามารถเขียนได้ ตารางเหตุการณ์ให้ค่านี้ | /subscriptions/{subscription-id}/resourceGroups/Storage/providers/Microsoft.Storage/storageAccounts/my-storage-account |
subject |
string | เส้นทางที่ผู้เผยแพร่กําหนดไปยังชื่อเรื่องของเหตุการณ์ | /blobServices/default/containers/my-file-system/blobs/new-file.txt |
type |
string | หนึ่งในชนิดเหตุการณ์ที่ลงทะเบียนแล้วสําหรับแหล่งข้อมูลเหตุการณ์นี้ | Microsoft.Storage.BlobCreated |
time |
string | เวลาที่เหตุการณ์ถูกสร้างขึ้นตามเวลา UTC ของผู้ให้บริการ | 2017-06-26T18:41:00.9584103Z |
id |
string | รหัสเฉพาะสําหรับเหตุการณ์ | 00000000-0000-0000-0000-000000000000 |
data |
ออบเจ็กต์ | ข้อมูลเหตุการณ์ที่เก็บข้อมูล Blob | {{Data object}} |
specversion |
string | เวอร์ชันข้อมูลจําเพาะของสคีมา CloudEvents | 1.0 |
fabricsource |
string | ID ของเหตุการณ์สตรีม Fabric สําหรับแหล่งข้อมูลเหตุการณ์ Azure Blob Storage | /tenants/00000000-0000-0000-0000-000000000000/workspaces/00000000-0000-0000-0000-000000000000/items/00000000-0000-0000-0000-000000000000 |
fabricsubject |
string | ID ของลิงก์เหตุการณ์สําหรับแหล่งข้อมูลเหตุการณ์ที่เก็บข้อมูล Azure Blob | eventLinks/00000000-0000-0000-0000-000000000000 |
วัตถุ data
มีคุณสมบัติต่อไปนี้:
คุณสมบัติ | ขนิด | รายละเอียด | ตัวอย่างเช่น |
---|---|---|---|
api |
string | การดําเนินการที่ทริกเกอร์เหตุการณ์ | CreateFile |
clientRequestId |
string | ID คําขอที่ให้มาโดยไคลเอ็นต์สําหรับการดําเนินการ API ที่เก็บข้อมูล ID นี้สามารถใช้เพื่อสัมพันธ์กับบันทึกการวินิจฉัย Azure Storage โดยใช้ client-request-id เขตข้อมูลในบันทึกและสามารถระบุในคําขอไคลเอ็นต์โดยใช้ x-ms-client-request-id ส่วนหัว ดู รูปแบบแฟ้มบันทึก |
00000000-0000-0000-0000-000000000000 |
requestId |
string | รหัสคําขอที่สร้างขึ้นโดยบริการสําหรับการดําเนินการ API ที่เก็บข้อมูล สามารถใช้เพื่อสัมพันธ์กับบันทึกการวินิจฉัยที่เก็บข้อมูล Azure โดยใช้ request-id-header เขตข้อมูลในบันทึก และถูกส่งกลับจากการเริ่มต้นการเรียกใช้ API ใน x-ms-request-id ส่วนหัว ดู รูปแบบแฟ้มบันทึก |
00000000-0000-0000-0000-000000000000 |
eTag |
string | ค่าที่คุณสามารถใช้เพื่อเรียกใช้การดําเนินการตามเงื่อนไข | \"0x8D4BCC2E4835CD0\" |
contentType |
string | ชนิดเนื้อหาที่ระบุสําหรับ blob | text/plain |
contentLength |
integer | ขนาดของ blob ในหน่วยไบต์ | 0 |
blobType |
string | ชนิดของ blob ค่าที่ถูกต้องคือ BlockBlob หรือPageBlob |
BlockBlob |
contentOffset |
ตัวเลข | ออฟเซตในหน่วยไบต์ของการดําเนินการเขียน ที่จุดซึ่งแอปพลิเคชันการทริกเกอร์เหตุการณ์เสร็จสิ้นการเขียนไปยังไฟล์ จะปรากฏขึ้นเฉพาะสําหรับเหตุการณ์ที่ถูกทริกเกอร์บนบัญชีที่เก็บข้อมูล blob ที่มี namespace แบบลําดับชั้น |
0 |
destinationUrl |
string | URL ของไฟล์ที่จะมีอยู่หลังจากการดําเนินการเสร็จสมบูรณ์ ตัวอย่างเช่น ถ้ามีการเปลี่ยนชื่อไฟล์ คุณสมบัติ destinationUrl จะมี URL ของชื่อไฟล์ใหม่ จะปรากฏขึ้นเฉพาะสําหรับเหตุการณ์ที่ถูกทริกเกอร์บนบัญชีที่เก็บข้อมูล blob ที่มี namespace แบบลําดับชั้น |
https://my-storage-account.dfs.core.windows.net/my-file-system/new-file.txt |
sourceUrl |
string | URL ของไฟล์ที่มีอยู่ก่อนที่จะดําเนินการเสร็จสิ้น ตัวอย่างเช่น ถ้ามีการเปลี่ยนชื่อไฟล์ sourceUrl จะมี URL ของชื่อไฟล์ต้นฉบับก่อนการดําเนินการเปลี่ยนชื่อ จะปรากฏขึ้นเฉพาะสําหรับเหตุการณ์ที่ถูกทริกเกอร์บนบัญชีที่เก็บข้อมูล blob ที่มี namespace แบบลําดับชั้น |
https://my-storage-account.dfs.core.windows.net/my-file-system/my-original-directory |
url |
string | เส้นทางไปยัง blob ถ้าไคลเอ็นต์ใช้ Blob REST API แล้ว url จะมีโครงสร้างนี้: |
https://myaccount.blob.core.windows.net/container01/file.txt |
recursive |
string | จริงในการเรียกใช้การดําเนินการบนไดเรกทอรีย่อยทั้งหมด มิฉะนั้นเป็น False จะปรากฏขึ้นเฉพาะสําหรับเหตุการณ์ที่ถูกทริกเกอร์บนบัญชีที่เก็บข้อมูล blob ที่มี namespace แบบลําดับชั้น |
true |
sequencer |
string | ค่าสตริงแบบเข้าใจไม่ได้แสดงลําดับตรรกะของเหตุการณ์สําหรับชื่อ blob เฉพาะใดๆ ผู้ใช้สามารถใช้การเปรียบเทียบสตริงมาตรฐานเพื่อทําความเข้าใจลําดับสัมพัทธ์ของสองเหตุการณ์บนชื่อ blob เดียวกัน | 00000000000004420000000000028963 |
identity |
string | ค่าสตริงที่แสดงถึงข้อมูลประจําตัวที่เชื่อมโยงกับเหตุการณ์ สําหรับ Secure File Transfer Protocol (SFTP) ค่าคือชื่อผู้ใช้ภายในเครื่อง | localuser |
storageDiagnostics |
ออบเจ็กต์ | ข้อมูลการวินิจฉัยรวมอยู่ในบริการที่เก็บข้อมูล Azure ในบางครั้ง เมื่อปรากฏแล้ว ผู้บริโภคเหตุการณ์ควรละเว้น | {{Storage diagnostic object}} |