Python을 사용하여 Azure Files을 개발합니다.

Azure Files를 사용하여 데이터를 저장하는 Python 애플리케이션을 개발하는 방법을 알아봅니다. Azure Files는 클라우드의 관리되는 파일 공유 서비스입니다. 업계 표준 SMB(서버 메시지 블록) 및 NFS(네트워크 파일 시스템) 프로토콜을 통해 액세스할 수 있는 완전히 관리되는 파일 공유를 제공합니다. 또한 Azure Files는 파일 공유에 프로그래밍 방식으로 액세스하기 위한 REST API를 제공합니다.

이 문서에서는 Python에서 Azure Files를 사용하여 개발하는 다양한 접근 방식과 앱의 요구 사항에 가장 적합한 방법을 선택하는 방법에 대해 알아봅니다. Azure Files 리소스와 상호 작용하는 기본 콘솔 앱을 만드는 방법도 알아봅니다.

적용 대상

관리 모델	청구 모델	미디어 계층	중복성	중소기업	네트워크 파일 시스템 (NFS)
Microsoft.Storage	프로비전된 v2	HDD(표준)	로컬(LRS)
Microsoft.Storage	프로비전된 v2	HDD(표준)	영역(ZRS)
Microsoft.Storage	프로비전된 v2	HDD(표준)	지역(GRS)
Microsoft.Storage	프로비전된 v2	HDD(표준)	GeoZone(GZRS)
Microsoft.Storage	프로비전된 v1	SSD(프리미엄)	로컬(LRS)
Microsoft.Storage	프로비전된 v1	SSD(프리미엄)	영역(ZRS)
Microsoft.Storage	종량제	HDD(표준)	로컬(LRS)
Microsoft.Storage	종량제	HDD(표준)	영역(ZRS)
Microsoft.Storage	종량제	HDD(표준)	지역(GRS)
Microsoft.Storage	종량제	HDD(표준)	GeoZone(GZRS)

Azure Files를 사용한 Python 앱 개발 정보

Azure Files는 Python 개발자가 Azure Files에서 데이터에 액세스하고 리소스를 관리하는 여러 가지 방법을 제공합니다. 다음 표에서는 접근 방식을 나열하고, 작동 방식을 요약하고, 각 방법을 사용하는 시기에 대한 지침을 제공합니다.

이러한 접근 방식에 대한 일반적인 내용은 Azure Files를 사용한 애플리케이션 개발 개요를 참조하세요.

이 문서에서는 다음 방법을 사용하여 Azure Files 리소스를 사용하는 방법에 중점을 둡니다.

• Python 파일 I/O 라이브러리를 사용하여 Azure Files 작업: SMB 또는 NFS를 사용하여 파일 공유를 탑재하고 Python 파일 I/O 라이브러리를 사용하여 공유의 파일 및 디렉터리로 작업합니다.
• Python용 파일 공유 클라이언트 라이브러리를 사용하여 Azure Files 작업: Python용 Azure Storage 파일 공유 클라이언트 라이브러리를 사용하여 파일 공유의 파일 및 디렉터리로 작업합니다. 이 클라이언트 라이브러리는 FileREST API를 기반으로 합니다.
• Azure Storage 관리 라이브러리를 사용하여 Azure Files 리소스 관리: Azure Storage 관리 라이브러리를 사용하여 스토리지 계정의 파일 공유 및 기타 리소스를 관리합니다. 관리 라이브러리는 Azure Storage 리소스 공급자 REST API를 기반으로 합니다.

필수 조건

• Azure 구독 - 체험 구독 만들기
• Azure Storage 계정 - 스토리지 계정 만들기
• Python 3.8 이상

프로젝트 설정

이 섹션에서는 Azure Files를 사용할 프로젝트를 준비하는 방법을 안내합니다.

프로젝트 디렉터리에서 명령을 사용하여 pip install 앱의 요구 사항에 따라 패키지를 설치합니다. 다음 예제에서는 Azure 파일 공유 클라이언트 라이브러리, 스토리지 관리 클라이언트 라이브러리 및 Azure ID 라이브러리를 설치하는 방법을 보여 줍니다. Azure 서비스에 암호 없이 연결하려면 azure-identity 패키지가 필요합니다.

pip install azure-identity
pip install azure-storage-file-share
pip install azure-mgmt-resource
pip install azure-mgmt-storage

코드 파일을 열고 필요한 import 문을 추가합니다.

Python os 및 io 라이브러리를 사용하려는 경우 .py 파일에 다음을 추가합니다.

import os
import io

Azure Storage 파일 공유 클라이언트 라이브러리를 사용하려는 경우 .py 파일에 다음을 추가합니다.

from azure.identity import DefaultAzureCredential
from azure.storage.fileshare import ShareClient, ShareDirectoryClient, ShareFileClient

Azure Storage 관리 라이브러리를 사용하려는 경우 .py 파일에 다음을 추가합니다.

from azure.identity import DefaultAzureCredential
from azure.mgmt.resource import ResourceManagementClient
from azure.mgmt.storage import StorageManagementClient

Python 파일 I/O 라이브러리를 사용하여 Azure 파일과 작업하기

표준 파일 I/O 라이브러리는 Azure Files 리소스에 액세스하고 작업하는 가장 일반적인 방법입니다. SMB 또는 NFS를 사용하여 파일 공유를 탑재하면 운영 체제에서 로컬 파일 시스템에 대한 API 요청을 리디렉션합니다. 이 방법을 사용하면 표준 파일 I/O 라이브러리(예: os 또는 io)를 사용하여 공유의 파일 및 디렉터리와 상호 작용할 수 있습니다.

앱에 다음이 필요할 때 Python 파일 I/O 라이브러리를 사용하는 것이 좋습니다.

• 앱 호환성: 이미 Python 파일 I/O 라이브러리를 사용하는 기존 코드가 있는 기간 업무 앱에 적합합니다. 앱이 Azure 파일 공유로 작동하도록 코드를 다시 작성할 필요가 없습니다.
• 사용 편의성: Python 파일 I/O 라이브러리는 개발자가 잘 알고 있으며 사용하기 쉽습니다. Azure Files의 주요 가치 제안은 SMB 및 NFS를 통해 네이티브 파일 시스템 API를 노출한다는 것입니다.

이 섹션에서는 Python 파일 I/O 라이브러리를 사용하여 Azure Files 리소스를 사용하는 방법을 알아봅니다.

자세한 내용 및 예는 다음 리소스를 참조하세요.

• 파일 I/O용 Python 라이브러리: os 및 io

파일 공유 탑재

Python 파일 I/O 라이브러리를 사용하려면 먼저 파일 공유를 탑재해야 합니다. SMB 또는 NFS를 사용하여 파일 공유를 탑재하는 방법에 대한 지침은 다음 리소스를 참조하세요.

• Windows에서 SMB 파일 공유 탑재
• Linux에서 SMB 파일 공유 탑재
• Linux에서 NFS 파일 공유 탑재

이 문서에서는 다음 경로를 사용하여 Windows에서 탑재된 SMB 파일 공유를 참조합니다.

file_share_path = "Z:\\file-share"

예: Python 파일 I/O 라이브러리를 사용하여 파일 공유에 연결하고 디렉터리를 열거합니다.

다음 코드 예제에서는 파일 공유에 연결하고 공유의 디렉터리를 나열하는 방법을 보여줍니다.

import os

def enumerate_directories(path):
    try:
        # Get all directories in the specified path
        dirs = [d for d in os.listdir(path) if os.path.isdir(os.path.join(path, d))]
        
        # Print each directory name
        for dir_name in dirs:
            print(f"{dir_name}")
            
        print(f"{len(dirs)} directories found.")
    except (PermissionError, FileNotFoundError, OSError) as ex:
        print(f"Error: {ex}")

#Example usage
file_share_path = "Z:\\file-share"
enumerate_directories(file_share_path)

예: Python 파일 I/O 라이브러리를 사용하여 파일 공유의 파일에 쓰기

다음 코드 예제에서는 파일에 텍스트를 쓰고 추가하는 방법을 보여 줍니다.

import os

def write_to_file(file_share_path, file_name):
    # First line of text with platform-appropriate line ending
    text_to_write = "First line" + os.linesep
    
    # Combine the file share path and filename
    file_path = os.path.join(file_share_path, file_name)
    
    # Write initial text to file (overwrites if file exists)
    with open(file_path, 'w') as file:
        file.write(text_to_write)
    
    # Text to append
    text_to_append = ["Second line", "Third line"]
    
    # Append lines to the file
    with open(file_path, 'a') as file:
        file.write(os.linesep.join(text_to_append) + os.linesep)

# Example usage
file_share_path = "Z:\\file-share"
write_to_file(file_share_path, "test.txt")

예: Python 파일 I/O 라이브러리를 사용하여 파일 ACL 열거

다음 코드 예제에서는 파일에 대한 기본 ACL(액세스 제어 목록)을 열거하는 방법을 보여 줍니다.

import os
import stat

def enumerate_file_acls(file_path):
    try:
        # Get file stats
        file_stat = os.stat(file_path)
        
        # Get permissions in octal format
        permissions_octal = oct(stat.S_IMODE(file_stat.st_mode))
        
        print(f"File: {file_path}")
        print(f"Permissions (octal): {permissions_octal}")
        
        # Interpret permissions in a human-readable format
        permissions = ""
        permissions += "r" if file_stat.st_mode & stat.S_IRUSR else "-"
        permissions += "w" if file_stat.st_mode & stat.S_IWUSR else "-"
        permissions += "x" if file_stat.st_mode & stat.S_IXUSR else "-"
        permissions += "r" if file_stat.st_mode & stat.S_IRGRP else "-"
        permissions += "w" if file_stat.st_mode & stat.S_IWGRP else "-" 
        permissions += "x" if file_stat.st_mode & stat.S_IXGRP else "-"
        permissions += "r" if file_stat.st_mode & stat.S_IROTH else "-"
        permissions += "w" if file_stat.st_mode & stat.S_IWOTH else "-"
        permissions += "x" if file_stat.st_mode & stat.S_IXOTH else "-"
        
        print(f"Permissions (symbolic): {permissions}")
        
        print(f"Owner ID: {file_stat.st_uid}")
        print(f"Group ID: {file_stat.st_gid}")
        print("Note: For detailed Windows ACLs, you may need a specialized library.")
        
    except FileNotFoundError:
        print(f"Error: File '{file_path}' not found.")
    except PermissionError:
        print(f"Error: Permission denied for '{file_path}'.")
    except Exception as e:
        print(f"Error: {e}")

# Example usage
file_share_path = "Z:\\file-share"
file_name = "test.txt"
file_path = os.path.join(file_share_path, file_name)

enumerate_file_acls(file_path)

Python용 파일 공유 클라이언트 라이브러리를 사용하여 Azure Files 데이터 작업

FileREST API는 Azure Files에 프로그래밍 방식으로 액세스할 수 있도록 합니다. 이를 통해 HTTPS 엔드포인트를 호출하여 파일 공유, 디렉터리 및 파일에 대한 작업을 수행할 수 있습니다. FileREST API는 네이티브 프로토콜을 통해 사용할 수 없는 높은 확장성 및 고급 기능을 위해 설계되었습니다. Azure SDK는 FileREST API를 기반으로 하는 Python용 파일 공유 클라이언트 라이브러리와 같은 클라이언트 라이브러리를 제공합니다.

애플리케이션에 다음이 필요한 경우 FileREST API 및 파일 공유 클라이언트 라이브러리를 사용하는 것이 좋습니다.

• 고급 기능: 네이티브 프로토콜을 통해 사용할 수 없는 작업 및 기능에 액세스합니다.
• 사용자 지정 클라우드 통합: Azure Files와 직접 상호 작용하는 백업, 바이러스 백신 또는 데이터 관리와 같은 사용자 지정 부가 가치 서비스를 빌드합니다.
• 성능 최적화: 데이터 평면 작업을 사용하는 대규모 시나리오의 성능 이점을 활용할 수 있습니다.

FileREST API는 Azure Files를 리소스 계층 구조로 모델화하며 디렉터리 또는 파일 수준에서 수행되는 작업에 권장됩니다. 파일 서비스 또는 파일 공유 수준에서 수행되는 작업에 스토리지 리소스 공급자 REST API를 사용하는 것이 좋습니다.

이 섹션에서는 파일 공유 클라이언트 라이브러리를 사용하여 Azure Files 리소스를 사용하는 방법을 알아봅니다.

자세한 내용 및 예는 다음 리소스를 참조하세요.

• Python용 Azure Storage 파일 공유 클라이언트 라이브러리
• Python 샘플용 Azure Storage 파일 공유 클라이언트 라이브러리

액세스 권한 부여 및 클라이언트 만들기

Azure Files에 앱을 연결하려면 개체를 만듭니다 ShareClient . 이 개체는 Azure Files 리소스를 사용하기 위한 시작점입니다. 다음 코드 예제에서는 다른 권한 부여 메커니즘을 사용 하 여 개체를 ShareClient 만드는 방법을 보여 줍니다.

from azure.identity import DefaultAzureCredential
from azure.storage.fileshare import ShareClient

account_name = "<account-name>"
share_name = "<share-name>"

# Create the share client using DefaultAzureCredential
share_client = ShareClient(
    account_url=f"https://{account_name}.file.core.windows.net",
    share_name=share_name,
    credential=DefaultAzureCredential(),
    # When using a token credential, you MUST specify a token_intent
    token_intent='backup'
)

# Get a reference to a directory in the share
directory_client = share_client.get_directory_client("sample-directory")

from azure.storage.fileshare import ShareClient

account_name = "<account-name>"
account_key = "<account-key>"
share_name = "<share-name>"
credential = account_key

# Create a share client using the account key
share_client = ShareClient(
    account_url=f"https://{account_name}.file.core.windows.net",
    share_name=share_name,
    credential=credential
)

# Get a reference to a directory in the share
directory_client = share_client.get_directory_client("sample-directory")

from azure.storage.fileshare import ShareClient

connection_string = "<connection-string>"
share_name = "<share-name>"

# Create a share client using the connection string
share_client = ShareClient.from_connection_string(connection_string, share_name)

# Get a reference to a directory in the share
directory_client = share_client.get_directory_client("sample-directory")

이러한 각 권한 부여 메커니즘에 대한 자세한 내용은 파일 데이터에 대한 액세스 권한을 부여하는 방법 선택을 참조하세요.

예: 파일 공유 클라이언트 라이브러리를 사용하여 파일 복사

다음 방법을 사용하여 파일 공유 내 또는 파일 공유 간에 파일을 복사할 수 있습니다.

• URL에서 복사 시작

BlobClient 개체에서 다음 메서드를 사용하여 파일을 대상 Blob에 복사할 수 있습니다.

• start_copy_from_url

다음 코드 예제에서는 다른 파일 공유의 파일에 파일을 복사하는 방법을 보여줍니다.

from azure.identity import DefaultAzureCredential
from azure.storage.fileshare import ShareFileClient

# Define storage account parameters
account_name = "<account-name>"
src_share_name = "src-file-share"
dest_share_name = "dest-file-share"
src_file_path = "src/path/to/file"
dest_file_path = "dest/path/to/file"

# Create token credential
token_credential = DefaultAzureCredential()

# Create source file client
src_file_client = ShareFileClient(
    account_url=f"https://{account_name}.file.core.windows.net",
    share_name=src_share_name,
    file_path=src_file_path,
    credential=token_credential,
    token_intent='backup'
)

# Create destination file client
dest_file_client = ShareFileClient(
    account_url=f"https://{account_name}.file.core.windows.net",
    share_name=dest_share_name,
    file_path=dest_file_path,
    credential=token_credential,
    token_intent='backup'
)

# Copy the file from the source share to the destination share
copy_operation = dest_file_client.start_copy_from_url(src_file_client.url)

예: 파일 공유 클라이언트 라이브러리를 사용하여 파일 임대

임대는 임대 ID를 통해 Azure에서 관리하는 파일에 대한 잠금을 만듭니다. 임대는 분산 시스템의 여러 클라이언트에서 파일에 대한 액세스를 조정하는 메커니즘을 제공합니다. 파일에 대한 임대는 단독 쓰기 및 삭제 액세스를 제공합니다. 임대 상태 및 작업에 대한 자세한 내용은 임대 파일을 참조하세요.

다음 코드 예제에서는 임대 클라이언트를 만들고, 파일에서 무한 기간 임대를 획득하고, 임대를 해제하는 방법을 보여줍니다.

from azure.identity import DefaultAzureCredential
from azure.storage.fileshare import ShareFileClient, ShareLeaseClient

# Define storage account parameters
account_name = "<account-name>"
share_name = "sample-file-share"
file_path = "path/to/file"

# Create a DefaultAzureCredential for authentication
token_credential = DefaultAzureCredential()

# Create a ShareFileClient
file_client = ShareFileClient(
    account_url=f"https://{account_name}.file.core.windows.net",
    share_name=share_name,
    file_path=file_path,
    credential=token_credential,
    token_intent='backup'
)

# Get a lease client for the file
lease_client = ShareLeaseClient(file_client)

# Acquire an infinite duration lease on the file
lease_info = lease_client.acquire()

# Do something with the file while it's leased
# ...

# Release the lease
lease_client.release()

SMB 및 FileREST API를 모두 사용하는 경우 FileREST API는 임대 를 사용하여 파일 잠금을 관리하는 반면 SMB는 운영 체제에서 관리하는 파일 시스템 잠금을 사용합니다. SMB와 FileREST API 간의 파일 잠금 상호 작용을 관리하는 방법에 대한 자세한 내용은 파일 잠금 관리를 참조하세요.

예: 파일 공유 클라이언트 라이브러리를 사용하여 공유 스냅샷 만들기 및 나열

공유 스냅샷은 특정 시점에 파일 공유의 읽기 전용 복사본입니다. 파일 공유의 스냅샷을 만든 다음 스냅샷을 사용하여 스냅샷을 만들 때 공유의 데이터에 액세스할 수 있습니다. 파일 공유의 모든 스냅샷을 나열하고 공유 스냅샷을 삭제할 수도 있습니다.

다음 코드 예제에서는 공유 스냅샷을 만들고, 파일 공유의 스냅샷을 나열하고, 공유 스냅샷의 루트 디렉터리를 트래버스하는 방법을 보여 줍니다.

from azure.storage.fileshare import ShareServiceClient, ShareDirectoryClient

def list_root_directory_snapshot(root_dir: ShareDirectoryClient):
    for item in root_dir.list_directories_and_files():
        if item["is_directory"]:
            print(f"Directory in snapshot: {item['name']}")
        else:
            print(f"File in snapshot: {item['name']}")

# Connection string with account key (required for share snapshots)
connection_string = "<connection-string>"

# Create service and share clients
share_service_client = ShareServiceClient.from_connection_string(connection_string)
share_name = "sample-file-share"
share_client = share_service_client.get_share_client(share_name)

# Create a snapshot
snapshot_info = share_client.create_snapshot()
print(f"Snapshot created: {snapshot_info['snapshot']}")

# List snapshots in a share
for share_item in share_service_client.list_shares(include_snapshots=True):
    if share_item["snapshot"]:
        print(f"Share: {share_item['name']} (Snapshot: {share_item['snapshot']})")

# List directories and files in a share snapshot
snapshot_timestamp = snapshot_info["snapshot"]
share_snapshot = share_service_client.get_share_client(share_name, snapshot=snapshot_timestamp)
root_dir = share_snapshot.get_directory_client("")

list_root_directory_snapshot(root_dir)

Azure Storage 관리 라이브러리를 사용하여 Azure Files 리소스 관리

Azure Storage 관리 라이브러리는 Azure Storage 리소스 공급자 REST API를 기반으로 합니다. Azure Storage 리소스 공급자는 Azure Resource Manager를 기반으로 하는 서비스이며 선언적(템플릿) 및 명령적(직접 API 호출) 메서드를 모두 지원합니다. Azure Storage 리소스 공급자 REST API는 파일 공유를 포함하여 Azure Storage 리소스에 프로그래밍 방식으로 액세스할 수 있도록 합니다. Azure SDK는 Azure Storage 리소스 공급자 REST API를 기반으로 빌드되는 관리 라이브러리를 제공합니다.

관리 라이브러리는 파일 서비스 또는 파일 공유 수준에서 수행되는 작업에 권장됩니다. 이 섹션에서는 Azure Storage 관리 라이브러리를 사용하여 Azure Files 리소스를 관리하는 방법을 알아봅니다.

예: Azure Storage 관리 라이브러리를 사용하여 파일 공유 만들기

다음 코드 예제에서는 최상위 ArmClient 개체를 만들고, Storage 리소스 공급자를 구독에 등록하고, Azure Storage 관리 라이브러리를 사용하여 파일 공유를 만드는 방법을 보여 줍니다.

from azure.identity import DefaultAzureCredential
from azure.mgmt.resource import ResourceManagementClient, SubscriptionClient
from azure.mgmt.storage import StorageManagementClient
from azure.mgmt.storage.models import FileShare

# Create the credential for authentication
credential = DefaultAzureCredential()

# Define variables
subscription_id = "<subscription-id>"
resource_group_name = "<resource-group-name>"
storage_account_name = "<storage-account-name>"
share_name = "sample-file-share"

# Create clients
resource_client = ResourceManagementClient(credential, subscription_id)
subscription_client = SubscriptionClient(credential)
storage_client = StorageManagementClient(credential, subscription_id)

# Register Microsoft.Storage resource provider, if not already registered
provider = resource_client.providers.get('Microsoft.Storage')
if provider.registration_state == "NotRegistered":
    resource_client.providers.register('Microsoft.Storage')

# Create a file share
file_share = storage_client.file_shares.create(
    resource_group_name=resource_group_name,
    account_name=storage_account_name,
    share_name=share_name,
    file_share=FileShare(
        share_quota=1  # Share size in GiB
        # Add other file share properties here
    )
)

클래스를 사용하여 FileShare 파일 공유 속성을 구성할 수 있습니다. 이전 예제에서는 속성을 설정하는 share_quota 방법을 보여줍니다. 자세한 내용은 StorageManagementClient 클래스 참조를 참조하세요.

예: Azure Storage 관리 라이브러리를 사용하여 파일 공유 및 스냅샷 나열

다음 코드 예제에서는 스토리지 계정에서 파일 공유 및 스냅샷을 나열하는 방법을 보여 줍니다.

from azure.identity import DefaultAzureCredential
from azure.mgmt.storage import StorageManagementClient

# Create the credential for authentication
credential = DefaultAzureCredential()

# Define variables
subscription_id = "<subscription-id>"
resource_group_name = "<resource-group-name>"
storage_account_name = "<storage-account-name>"
expand = "snapshots"  # Include snapshots in the response

# Create storage management client
storage_client = StorageManagementClient(credential, subscription_id)

# List all file shares with their snapshots
file_shares = storage_client.file_shares.list(
    resource_group_name=resource_group_name,
    account_name=storage_account_name,
    expand=expand
)

# Iterate over the file shares and print them along with any snapshots
for share in file_shares:
    print(f"Resource name: {share.name}")
    if share.snapshot_time:
        print(f"Snapshot: {share.snapshot_time}")

관련 콘텐츠

Azure Files를 사용하여 개발하는 방법에 대한 자세한 내용은 다음 리소스를 참조하세요.

• Azure Files를 사용한 애플리케이션 개발 개요
• 공유, 디렉터리, 파일 및 메타데이터 이름 지정 및 참조
• 파일 잠금 관리
• 디렉터리에 대한 작업
• 파일에 대한 작업