azure storage python

Microsoft Azure Storage SDK สำหรับ Python (เลิกใช้แล้ว)

โปรเจ็กต์นี้จะอยู่ใน [การสนับสนุนชุมชน](https://azure.github.io/azure-sdk/policies_support.html#package-lifecycle) จนถึงวันที่ 13 กันยายน 2024 หลังจากวันที่นี้ โปรเจ็กต์และไลบรารีไคลเอ็นต์ที่เกี่ยวข้องจะถูกยกเลิกอย่างถาวร . สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับการยุติการให้บริการและทางเลือกอื่น ๆ ในการใช้โปรเจ็กต์นี้ โปรดไปที่ [ประกาศการเกษียณอายุ: ไลบรารีไคลเอนต์ Azure Storage Python ดั้งเดิมจะถูกยกเลิกในวันที่ 13 กันยายน 2024](https://azure.microsoft.com/updates/retirement-notice- the-legacy-azure-storage-python-client-libraries-will-be-retired-on-13-september-2024/)

---

ข่าว!! azure-storage-blob v12 เป็น GA แล้ว!

ไปที่ https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage เพื่อเรียนรู้เพิ่มเติม

หมายเหตุ : repo ปัจจุบันมีไว้สำหรับ azure-storage-blob<=2.1.0 การอัปเกรดเป็น v12.0.0 อาจทำให้รหัสปัจจุบันของคุณเสียหาย

โปรเจ็กต์นี้มีไลบรารีไคลเอนต์ใน Python ที่ทำให้การใช้บริการ Microsoft Azure Storage เป็นเรื่องง่าย สำหรับเอกสารประกอบ โปรดดูที่ศูนย์นักพัฒนา Microsoft Azure Python และการอ้างอิง API ของเรา (ยังมีอยู่ใน readthedocs)

หากคุณกำลังมองหา Service Bus หรือไลบรารี Azure Management โปรดไปที่ https://github.com/Azure/azure-sdk-for-python

ความเข้ากันได้

สิ่งสำคัญ : หากคุณมีแพ็คเกจ Azure เวอร์ชันก่อนหน้า (เวอร์ชัน < 1.0) คุณควรถอนการติดตั้งก่อนติดตั้งแพ็คเกจนี้

คุณสามารถตรวจสอบเวอร์ชันได้โดยใช้ pip:

pip freeze

หากคุณเห็น azure==0.11.0 (หรือเวอร์ชันใดๆ ที่ต่ำกว่า 1.0) ให้ถอนการติดตั้งก่อนแล้วจึงติดตั้งอีกครั้ง:

pip uninstall azure
pip install azure

หากคุณกำลังอัปเกรดจากเวอร์ชันที่เก่ากว่า 0.30.0 โปรดดูเอกสารการอัปเกรด ตัวอย่างการใช้งานในไดเร็กทอรีตัวอย่าง และ ChangeLog และ BreakingChanges

หากคุณประสบปัญหาในการติดตั้งที่เก็บข้อมูล Azure บน Azure Web Apps การอัปเกรด pip อาจช่วยได้

สิ่งสำคัญ : หากคุณมีแพ็คเกจ azure-storage เวอร์ชันก่อนหน้า (เวอร์ชัน <= 0.36.0) คุณควรถอนการติดตั้งก่อนติดตั้งแพ็คเกจแยกใหม่

คุณสามารถตรวจสอบเวอร์ชันได้โดยใช้ pip:

pip freeze

หากคุณเห็น azure-storage==0.36.0 (หรือเวอร์ชันใดๆ ที่ต่ำกว่า 0.36.0) ให้ถอนการติดตั้งก่อน:

pip uninstall azure-storage

คุณสมบัติ

• หยด
  • สร้าง/อ่าน/อัปเดต/ลบคอนเทนเนอร์
  • สร้าง/อ่าน/อัปเดต/ลบ Blobs
  • การดำเนินการ Blob ขั้นสูง
• คิว
  • สร้าง/ลบคิว
  • แทรก/ดูข้อความคิว
  • การดำเนินการคิวขั้นสูง
• ไฟล์
  • สร้าง/อัปเดต/ลบการแชร์
  • สร้าง/อัพเดต/ลบไดเร็กทอรี
  • สร้าง/อ่าน/อัปเดต/ลบไฟล์
  • การดำเนินการไฟล์ขั้นสูง

เริ่มต้นใช้งาน

ดาวน์โหลด

Azure Storage SDK สำหรับ Python ประกอบด้วย 5 แพ็คเกจ:

• สีฟ้าการจัดเก็บหยด
  • ประกอบด้วย API ของบริการ Blob
• ไฟล์ Azure-Storage
  • ประกอบด้วย API ของบริการไฟล์
• คิวการจัดเก็บสีฟ้า
  • ประกอบด้วย API การบริการคิว
• สีฟ้า-การจัดเก็บทั่วไป
  • มีรหัสทั่วไปที่แชร์โดย blob ไฟล์และคิว
• สีฟ้า-storage-nspkg
  • เป็นเจ้าของเนมสเปซ azure.storage ผู้ใช้ไม่ควรใช้สิ่งนี้โดยตรง

หมายเหตุ : ก่อนและรวมถึงเวอร์ชัน 0.36.0 เคยมีแพ็คเกจเดียว (ที่เก็บข้อมูลสีฟ้า) ที่มีบริการทั้งหมด ไม่รองรับอีกต่อไป และผู้ใช้ควรติดตั้งแพ็คเกจบริการ 3 แพ็คเกจที่กล่าวถึงข้างต้นทีละรายการ ขึ้นอยู่กับความต้องการ นอกจากนี้ แพ็คเกจ ตาราง จะไม่ถูกปล่อยออกมาภายใต้เนมสเปซที่เก็บข้อมูล azure อีกต่อไป โปรดดูที่ cosmosdb

ตัวเลือกที่ 1: ผ่าน PyPi

หากต้องการติดตั้งผ่าน Python Package Index (PyPI) ให้พิมพ์:

 pip ติดตั้ง azure-storage-blob.php
pip ติดตั้งไฟล์ azure-storage-file
pip ติดตั้ง azure-storage-queue.php

ตัวเลือกที่ 2: แหล่งที่มาผ่าน Git

หากต้องการรับซอร์สโค้ดของ SDK ผ่าน git เพียงพิมพ์:

 โคลนคอมไพล์ git://github.com/Azure/azure-storage-python.git

cd ./azure-storage-python/azure-storage-nspkg
หลาม setup.py ติดตั้ง

cd ../azure-storage-common
หลาม setup.py ติดตั้ง

cd ../azure-storage-blob
หลาม setup.py ติดตั้ง

แทนที่ azure-storage-blob ด้วย azure-storage-file หรือ azure-storage-queue เพื่อติดตั้งบริการอื่นๆ

ตัวเลือกที่ 3: ซอร์สซิป

ดาวน์โหลดรหัสไปรษณีย์ผ่าน GitHub หรือ PyPi จากนั้นทำตามคำแนะนำเดียวกันในตัวเลือกที่ 2

ข้อกำหนดขั้นต่ำ

• หลาม 2.7, 3.3-3.7
• ดู setup.py สำหรับการอ้างอิง

การใช้งาน

หากต้องการใช้ SDK นี้เพื่อเรียกใช้บริการพื้นที่เก็บข้อมูล Microsoft Azure คุณต้องสร้างบัญชีก่อน

การบันทึก

เพื่อให้การแก้ไขจุดบกพร่องง่ายขึ้น ขอแนะนำให้เปิดการบันทึกสำหรับตัวบันทึกชื่อ 'azure.storage' ต่อไปนี้เป็นการกำหนดค่าตัวอย่างสองแบบ:

 # Basic configuration: configure the root logger, including 'azure.storage'
logging . basicConfig ( format = '%(asctime)s %(name)-20s %(levelname)-5s %(message)s' , level = logging . INFO )

 # More advanced configuration allowing more control
logger = logging . getLogger ( 'azure.storage' )
handler = logging . StreamHandler ()
formatter = logging . Formatter ( '%(asctime)s %(name)-20s %(levelname)-5s %(message)s' )
handler . setFormatter ( formatter )
logger . addHandler ( handler )
logger . setLevel ( logging . INFO )

นี่คือวิธีที่เราใช้ระดับการบันทึก ขอแนะนำให้ใช้ INFO:

• DEBUG: บันทึกสตริงที่จะลงนาม
• ข้อมูล: บันทึกคำขอและการตอบกลับขาออก รวมถึงลองอีกครั้ง
• คำเตือน: ไม่ได้ใช้
• ข้อผิดพลาด: บันทึกการโทรที่ยังคงล้มเหลวหลังจากลองใหม่ทั้งหมด

ตัวอย่างโค้ด

ดูไดเร็กทอรีตัวอย่างสำหรับตัวอย่างการใช้งาน blob, คิว และไฟล์

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

อย่าลืมตรวจสอบฟอรัมนักพัฒนา Microsoft Azure บน MSDN หรือฟอรัมนักพัฒนาบน Stack Overflow หากคุณมีปัญหากับโค้ดที่ให้มา

ร่วมเขียนโค้ดหรือแสดงความคิดเห็น

หากคุณต้องการเป็นผู้สนับสนุนโครงการนี้ โปรดปฏิบัติตามคำแนะนำที่ให้ไว้ในแนวทางการสนับสนุนโครงการ Azure ดูรายละเอียดเพิ่มเติมสำหรับการบริจาคได้ในเอกสาร CONTRIBUTING.md

หากคุณพบข้อบกพร่องใดๆ กับไลบรารี โปรดแจ้งปัญหาในส่วนปัญหาของโครงการ

เรียนรู้เพิ่มเติม

• ศูนย์นักพัฒนาหลาม
• บริการจัดเก็บข้อมูล Azure
• บล็อกของทีมพื้นที่เก็บข้อมูล Azure
• การอ้างอิง API