SDK de almacenamiento de Microsoft Azure para Python (obsoleto)
Este proyecto estará en [Soporte comunitario](https://azure.github.io/azure-sdk/policies_support.html#package-lifecycle) hasta el 13 de septiembre de 2024. Después de esta fecha, el proyecto y las bibliotecas cliente asociadas se retirarán permanentemente. . Para obtener más detalles sobre el retiro y las alternativas al uso de este proyecto, visite [Aviso de retiro: las bibliotecas cliente heredadas de Azure Storage Python se retirarán el 13 de septiembre de 2024](https://azure.microsoft.com/updates/retirement-notice- las-bibliotecas-cliente-de-python-legacy-azure-storage-se-retirarán-el-13-de-septiembre-2024/).
¡¡NOTICIAS!! ¡Azure-storage-blob v12 ya está disponible en GA!
Visite https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage para obtener más información.
Nota : el repositorio actual es para azure-storage-blob<=2.1.0, la actualización a v12.0.0 podría alterar su código actual.
Este proyecto proporciona una biblioteca cliente en Python que facilita el consumo de los servicios de Microsoft Azure Storage. Para obtener documentación, consulte el Centro de desarrolladores de Microsoft Azure Python y nuestra Referencia de API (también disponible en readthedocs).
Si busca las bibliotecas de Service Bus o Azure Management, visite https://github.com/Azure/azure-sdk-for-python.
IMPORTANTE : si tiene una versión anterior del paquete azure (versión <1.0), debe desinstalarla antes de instalar este paquete.
Puedes verificar la versión usando pip:
pip freeze
Si ve azure==0.11.0 (o cualquier versión inferior a 1.0), desinstálelo primero y luego instálelo nuevamente:
pip uninstall azure
pip install azure
Si está actualizando desde una versión anterior a 0.30.0, consulte el documento de actualización, los ejemplos de uso en el directorio de ejemplos y el ChangeLog y BreakingChanges.
Si tiene problemas al instalar Azure Storage en Azure Web Apps, actualizar pip podría resultar útil.
IMPORTANTE : si tiene una versión anterior del paquete azure-storage (versión <= 0.36.0), debe desinstalarla antes de instalar los nuevos paquetes divididos.
Puedes verificar la versión usando pip:
pip freeze
Si ve azure-storage==0.36.0 (o cualquier versión inferior a 0.36.0), desinstálelo primero:
pip uninstall azure-storage
El SDK de Azure Storage para Python se compone de cinco paquetes:
Nota : antes de la versión 0.36.0 incluida, solía haber un único paquete (azure-storage) que contenía todos los servicios. Ya no es compatible y los usuarios deben instalar los 3 paquetes de servicios mencionados anteriormente individualmente, según la necesidad. Además, el paquete de tablas ya no se publica en el espacio de nombres azure-storage; consulte cosmosdb.
Para instalar a través del índice de paquetes de Python (PyPI), escriba:
pip instala azure-storage-blob pip instala el archivo-almacenamiento-azure pip instala cola-de-almacenamiento-azul
Para obtener el código fuente del SDK a través de git simplemente escribe:
git clon git://github.com/Azure/azure-storage-python.git cd ./azure-storage-python/azure-storage-nspkg instalación de python setup.py cd ../azure-almacenamiento-común instalación de python setup.py cd ../blob-de-almacenamiento-azure instalación de python setup.py
Reemplace azure-storage-blob con azure-storage-file o azure-storage-queue para instalar los otros servicios.
Descargue un zip del código a través de GitHub o PyPi. Luego siga las mismas instrucciones en la opción 2.
Para utilizar este SDK para llamar a los servicios de almacenamiento de Microsoft Azure, primero debe crear una cuenta.
Para facilitar la depuración, se recomienda activar el registro para el registrador denominado "azure.storage". Aquí hay dos configuraciones de ejemplo:
# 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 )
Así es como usamos los niveles de registro; se recomienda usar INFO:
Consulte el directorio de ejemplos para ver ejemplos de uso de archivos, colas y blobs.
Asegúrese de consultar los foros de desarrolladores de Microsoft Azure en MSDN o los foros de desarrolladores en Stack Overflow si tiene problemas con el código proporcionado.
Si desea convertirse en colaborador activo de este proyecto, siga las instrucciones proporcionadas en Pautas de contribución de proyectos de Azure. Puede encontrar más detalles sobre cómo contribuir en el documento CONTRIBUTING.md.
Si encuentra algún error en la biblioteca, presente un problema en la sección Problemas del proyecto.