Tacaíonn FastAPI le async def agus def rialta araon do oibríochtaí cosáin. Is tábhachtach an rogha seo do fheidhmíochta: úsáid async def nuair is féidir leat ar oibríochtaí I/O nach bhlonaigíonn, agus rialta nuair a ghlaodh do chód ar oibríochtaí blonaigthe (sioncronach).
awaitdef@app.get("/async")
async def async_endpoint():
data = await fetch_from_api() # await non-blocking I/O — efficient
return data
@app.get("/sync")
def sync_endpoint():
data = blocking_db_call() # ordinary blocking code
return data
async def → runs on the main event loop. Efficient ONLY if you await non-blocking calls.
⚠️ A BLOCKING call inside async def blocks the WHOLE event loop → kills concurrency!
def → FastAPI runs it in a THREAD POOL, so blocking code doesn't block the event loop.
Safe for synchronous/blocking libraries.
# ✅ async def — when you can await async libraries (httpx, async DB drivers)
async def get_user():
async with httpx.AsyncClient() as c:
return await c.get(url)
# ✅ plain def — when using SYNCHRONOUS/blocking libraries (requests, sync ORM)
def get_user():
return requests.get(url).json() # blocking → FastAPI runs it in a thread
# ❌ THE DANGEROUS MISTAKE — blocking call inside async def
async def bad():
return requests.get(url).json() # blocks the event loop! Use `def` or an async client
An riail chriticiúil: ná cuir glaonna blonaigthe i async def ar chor ar bith — blonaígíonn sé an lúp imeall agus scriosaíonn sé comhiomlánúlacht. Úsáid leabharlann async le await, nó úsáid def simplí (a reathraíonn FastAPI go sábháilte i bpúl snáithe).
Bainistríonn an rogha cheart idir async def agus def go díreach tionchar ar fheidhmíochta agus comhiomlánúlacht do API, agus is earráid choitianta, dhubhthrom é an rogha a dhéanamh go dona.
An gealltanas eolaíochta is ea async def a bheith ina bhabhtá nuair a bhíonn tú ag await oibríochtaí nach bhlonaigíonn — má chuireann tú glaoch blonaigthe (mar shampla an leabharlann sioncronach requests nó tiománaí bunachar sonraí blonaigthe) in async def, blonaígíonn sé an lúp imeall ar fad, fríozthaíonn sé gach iarratas comhthráthach agus cuireann sé deireadh ar an sprioc den async.
Os a choinne sin, reathraíonn FastAPI go cliste endpoints def simplí i bpúl snáithe, agus dá bhrí sin tá cód sioncronach/blonaigthe sábháilte ann.
A thuiscint ar an riail seo — async def a úsáid le leabharlanna i ndáiríribh async, def simplí a úsáid do chód blonaigthe, agus glaonna blonaigthe a chur go brách i async def — tá sé riachtanach do endpoints FastAPI a scríobh atá éifeachtach agus d'earráid shimplí ach millteach a sheachaint ar dhóichí go raibh tú ag uimhriú go tubaisteach gach iarratas taobh thiar de lúp imeall blonaigthe.