Microsoft MVP성태의 닷넷 이야기
스크립트: 58. 파이썬 - async/await 기본 사용법 [링크 복사], [링크+제목 복사],
조회: 13735
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
 

(시리즈 글이 3개 있습니다.)
스크립트: 58. 파이썬 - async/await 기본 사용법
; https://www.sysnet.pe.kr/2/0/13423

스크립트: 59. 파이썬 - 비동기 호출 함수(run_until_complete, run_in_executor, create_task, run_in_threadpool)
; https://www.sysnet.pe.kr/2/0/13426

스크립트: 71. 파이썬 - asyncio의 ContextVar 전달
; https://www.sysnet.pe.kr/2/0/13899




파이썬 - async/await 기본 사용법

C# 개발자라면, 파이썬의 async/await를 유사한 경험으로 사용할 수 있습니다. 우선, 간단하게 콘솔 앱으로 예제를 작성해 볼까요? ^^

async def main_async():
    print('async called')

await main_async()

""" 
실행 결과:

  File "C:\test\main.py", line 6
    await main_async()
    ^
SyntaxError: 'await' outside function
"""

위의 코드를 실행하면 "실행 결과"에서 보는 바대로 await을 함수 밖에서 사용했다고 오류가 발생합니다. 그래서 이것을 함수에 담아서 다시 호출해 보면,

import time

async def do_something(delay: int=0):
    time.sleep(delay)
    return delay

def main():
    await do_something(3)

main()


""" 
실행 결과:

  File "/home/testusr/main.py", line 10
    await do_something(3)
    ^
SyntaxError: 'await' outside async function
"""

이번엔 async 함수가 아닌 곳에서 사용했다고 나옵니다. 그렇다면 main 함수를 async로 만들어야 하지만,

async def main():
    await do_something(3)

main()

""" 
실행 결과:

/home/testusr/main.py:12: RuntimeWarning: coroutine 'main' was never awaited
  main()
RuntimeWarning: Enable tracemalloc to get the object allocation traceback
"""

그럼 main 함수가 비동기 호출 처리가 안 되었다는 불평을 하게 되므로, 결국 main 호출도 "await main()"으로 바꿔야 하고 문제가 다시 원점으로 돌아가게 됩니다.




C#은 Main 메서드 시작부터 async Main으로 만드는 것이 가능하지만 파이썬은 그에 대한 처리는 없기 때문에 이런 경우 라이브러리의 도움을 받아야 합니다. 실제로 최초의 async 진입 함수를 asyncio.run 등의 함수를 이용해 실행하면,

import time
import asyncio

async def main_async():
    print('async calling', time.strftime('%X'))
    time.sleep(5)
    print('async called', time.strftime('%X'))

asyncio.run(main_async())

""" 
실행 결과:

async calling 14:06:08
async called 14:06:13
""" 

아무런 문제 없이 코드가 수행됩니다. 또한 await을 순차적으로 비동기 처리하는 것은 C#의 체계와 같습니다. 그래서 아래의 코드는 총 9초를 소요하게 되는데요,

import time
import asyncio

async def do_something(delay: int=0):
    time.sleep(delay)


async def main_async():
    print('async calling', time.strftime('%X'))
    await do_something(3)
    await do_something(6)
    print('async called', time.strftime('%X'))  # 9초 지나서 실행
                                                # 아래에서 다루겠지만, do_something 함수 내부의 코드 문제로 비동기 처리와 무관하게 9초가 걸립니다.
    

asyncio.run(main_async())

그렇다면 병렬처리는 어떻게 할 수 있을까요? C#의 경우라면 개별 호출을 Task로 받아 await을 별도로 진행하거나 Task.WhenAll로 받을 수 있는데요, 파이썬도 유사한 사용자 경험을 제공합니다.

실제로 해볼까요? ^^ 우선, C#처럼 다음과 같이 코딩하면,

task1 = do_something(3)  # 동기 호출: 이곳에서 time.sleep(3) 코드 동작
task2 = do_something(6)  # 동기 호출: 이곳에서 time.sleep(6) 코드 동작

await task1
await task2

위의 호출은 총 9초가 소요됩니다. 사실 "task1 = do_something(...)" 형식이 동기 호출이든 비동기 호출이든 상관없이 저 코드는 총 9초가 소요됩니다. 왜냐하면 do_something의 내부에 있는 time.sleep이 동기적으로 호출되기 때문에 그것을 호출하는 측의 스레드가 그대로 묶이기 때문입니다.

따라서, 이 문제를 없애려면 time.sleep도 비동기 버전을 사용해야 합니다.

async def do_something(delay: int=0):
    await asyncio.sleep(delay)


task1 = do_something(3)  # 동기 호출이지만 asyncio.sleep 비동기 호출로 3초를 대기하지 않고 제어 반환
task2 = do_something(6)  # 동기 호출이지만 asyncio.sleep 비동기 호출로 6초를 대기하지 않고 제어 반환

await task1  # 이곳에서 비동기 3초 작업 대기
await task2  # 이미 3초가 흘렀으므로 남은 비동기 3초 대기

# 총 6초 소요

보는 바와 같이, 이제야 원하는 대로 병렬 처리가 잘 되었습니다. (저렇게 보면 C#의 코드와 거의 같습니다.)

또한, 파이썬 역시 C#의 Task.WhenAll과 유사하게 병렬 처리를 위한 전용 함수인 asyncio.gather를 제공합니다. 따라서 이것을 이용하면 다음과 같이 재작성할 수 있습니다.

# Can I use await on multiple functions at once?
# https://stackoverflow.com/questions/68733675/can-i-use-await-on-multiple-functions-at-once

import time
import asyncio

async def do_something(delay: int=0):
    await asyncio.sleep(delay)


async def main_async():
    print('async calling', time.strftime('%X'))

    await asyncio.gather(do_something(3), do_something(6))  # 6초 소요

    print('async called', time.strftime('%X'))


asyncio.run(main_async())

참고로, gather의 경우 인자를 개별적으로 지정하는데, 인자가 포함된 리스트를 받는 wait 함수를 쓰는 것도 가능합니다. (gather/wait)

async def main_async():
    print('async calling', time.strftime('%X'))

    jobs = [do_something(3), do_something(6)]  # 리스트로 전달
    await asyncio.wait(jobs)  # 6초 소요

    print('async called', time.strftime('%X'))




[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]







[최초 등록일: ]
[최종 수정일: 10/13/2023]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 작성자
 




[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
13979정성태7/30/202558Linux: 118. eBPF - BPF_PROG_TYPE_CGROUP_SOCK 유형에서 정상 동작하지 않는 BPF_CORE_READ
13978정성태7/29/2025185오류 유형: 970. 파일 복사 시 "Data error (cyclic redundancy check). (0x80070017)" 에러
13977정성태7/28/2025363닷넷: 2349. C# 14 - (5) 문자열 리터럴을 utf-8 인코딩으로 저장파일 다운로드1
13976정성태7/25/2025555닷넷: 2348. C# - 카카오 카나나 모델 + Microsoft.ML.OnnxRuntimeGenAI 예제파일 다운로드1
13975정성태7/23/2025719닷넷: 2347. C# 14 - (4) 형식 인자가 없는 제네릭 타입의 nameof 지원파일 다운로드1
13974정성태7/22/2025882닷넷: 2346. C# 14 - (3) Span 타입과 배열 간의 암시적 형변환파일 다운로드1
13973정성태7/21/2025838닷넷: 2345. C# - 배열 및 Span의 공변성파일 다운로드1
13972정성태7/21/20251115닷넷: 2344. C#의 Identity conversion 의미파일 다운로드1
13971정성태7/17/20251381닷넷: 2343. C# 14 - (2) 속성 구문에서 문맥 키워드로 추가되는 field 예약어파일 다운로드1
13970정성태7/17/20251378닷넷: 2342. C# 14 - (1) (예약)
13969정성태7/17/20251430닷넷: 2341. snap으로 설치한 .NET 리눅스 실행 환경
13968정성태7/16/20251309오류 유형: 969. lddtree - TypeError: 'type' object is not subscriptable
13967정성태7/16/20251821오류 유형: 968. snap으로 설치한 "dotnet run" 실행 시 "undefined symbol: _dl_audit_symbind_alt, version GLIBC_PRIVATE" 오류
13966정성태7/15/20252360디버깅 기술: 223. WinDbg - .kframes 명령어
13965정성태7/11/20251653오류 유형: 967. 디버깅 모드로 실행 시 "Could not find file 'C:\Program Files\IIS Express\Oracle.DataAccess.Common.Configuration.Section.xsd'" 예외
13964정성태7/10/20252315닷넷: 2340. C# - Win32 Multimedia Timer 주기파일 다운로드1
13963정성태7/8/20251869VS.NET IDE: 202. Visual Studio 2022 + Copilot 기본 사용법
13962정성태7/7/20251883스크립트: 79. 파이썬 - onnxruntime_genai에서 지원하지 않는 모델 사용
13961정성태7/5/20251591디버깅 기술: 222. WinDbg 분석 사례 - IISreset 시점에 w3wp.exe의 crash 발생
13960정성태7/3/20252776개발 환경 구성: 752. ProcDump - C/C++ 예외 코드 필터를 지정한 덤프 생성 [2]
13959정성태6/25/20251731오류 유형: 966. Ubuntu - ping: connect: Network is unreachable
13958정성태6/21/20252444닷넷: 2339. C# - Phi-4-multimodal 모델의 GPU 가속 방법 (ORT 사용)파일 다운로드1
13957정성태6/20/20252905닷넷: 2338. C# / Foundry Local - Phi-4-multimodal 모델을 사용하는 방법 [1]
13956정성태6/19/20252630개발 환경 구성: 751. Triton Inference Server의 Python Backend 프로세스
13955정성태6/18/20252804오류 유형: 965. Hugging Face 모델 다운로드 시 "requests.exceptions.HTTPError: 401 Client Error: Unauthorized for url: ..." 오류
[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...