Kurzorobjektum¶

Cursor.__enter__()¶

a kurzor mint kontextuskezelő belépési pontja. Magától visszatér.

Cursor.__exit__()¶

a kurzor kilépési pontja kontextuskezelőként. Bezárja a kurzort.

Cursor.arraysize¶

ez az írás-olvasás attribútum használható az adatbázisba érkező belső hívások által internálisan rögzített és pufferelt sorok számának beállítására a ROWSFROM SELECT utasítások és REF kurzorok lekérésekor. Az érték drasztikusan befolyásolhatja a lekérdezés teljesítményét, mivel közvetlenül befolyásolja a Python és az adatbázis közötti networkround utak számát. Az olyan módszerek esetében, mint afetchone() és a fetchall(), nem változik, hogy hány sor kerül vissza az alkalmazásba. Afetchmany() esetében ez a beolvasandó sorok alapértelmezett száma.

a teljesítmény előnyei miatt az alapértelmezett Cursor.arraysize 100A DB API által ajánlott 1 helyett. Ez az érték azt jelenti, hogy 100 sorminden belső hívás az adatbázisba kerül.

további információkért lásd: Tuning Fetch Performance.

Cursor.bindarraysize¶

ez az írás-olvasás attribútum meghatározza a kötendő sorok számát egy időbenés a setinputsizes() vagyvar()változók létrehozásakor használatos. Ez alapértelmezés szerint 1 jelentése kötni egy sor atime.

Cursor.arrayvar(datatype, value) (

hozzon létre egy tömbváltozót, amely az adott típusú és méretű kurzorhoz kapcsolódik, majd adjon vissza egy változó objektumot. Az érték vagy aninteger, amely meghatározza a kiosztandó elemek számát, vagy egy lista ésa kiosztott elemek száma a lista méretéből származik. Ha az érték egy lista, akkor a változó a lista tartalmával is be van állítva. Ha a méret nincs megadva, és a típus egy string vagy bináris, 4000 bájt allokált. Erre azért van szükség, hogy a tömböket PL/SQL-be továbbítsuk (olyan esetekben, amikor a lista üres lehet, és a típus nem határozható meg automatikusan) vagy a tömbök PL/SQL-ből való visszatéréséhez.

tömb változók csak akkor használható PL/SQL asszociatív tömbök val velegybefüggő kulcsokat. PL / SQL asszociatív tömbök esetén ritkán lakott kulcsokkalvagy varratokhoz és beágyazott táblákhoz, az ebben a példában bemutatott megközelítést kell használni.

Cursor.bindnames()¶

adja vissza az utasításhoz kötött bind változónevek listáját. Vegye figyelembe, hogy a nyilatkozatot először el kell készíteni.

Cursor.bindvars¶

ez a csak olvasható attribútum biztosítja a lastexecute-hoz használt kötési változókat. Az érték lista vagy szótár lesz attól függően, hogy a kötés pozíció vagy név szerint történt-e. Óvatosan kell eljárni, amikorhivatkozás erre az attribútumra. Különösen az elemeket nem szabad eltávolítanivagy cserélni.

Cursor.callfunc(name, returnType, parameters=, keywordParameters= {}) a megadott névvel rendelkező függvény hívása. A visszatérési típus augyanaz a jelölés, amelyet asetinputsizes()igényel. A paraméterek sorrendjének tartalmaznia kell egy bejegyzést minden egyes paraméterhez, amelyet a függvény elvár. Bármely kulcsszóparaméter szerepelni fog apozíciós paraméterek. A hívás eredménye a visszatérési értékfunkciót.

lásd PL / SQL tárolt függvények egy példát.

Cursor.callproc(név, paraméterek=, keywordParameters= {}) a megadott névvel rendelkező eljárást hívjuk meg. A paraméterek sorrendjének meg kell felelnietartalmaz egy bejegyzést minden olyan paraméterhez, amelyet az eljárás elvár. A hívás eredménye a bemeneti sorrend módosított másolata. A bemeneti paraméterek érintetlenek maradnak; a kimeneti és az input/output paramétereket esetleg új értékek váltják fel. A kulcsszóparaméterek a pozícióparaméterek után kerülnek beillesztésre, és nem kerülnek vissza a kimeneti sorozat részeként.

lásd PL / SQL tárolt eljárások egy példát.

Cursor.close()¶

zárja be a kurzort most, ahelyett, hogy bármikor__ del _ _ hívják. A kurzor ettől a ponttól kezdve használhatatlan lesz; hiba kivétel lesz emelve, ha bármilyen műveletet megkísérelnek a kurzorral.

Cursor.connection¶

ez a csak olvasható attribútum hivatkozást ad vissza a kapcsolatobjektumra, amelyen a kurzor létrejött.

Cursor.description¶

ez a csak olvasható attribútum 7 elemből álló szekvenciák sorozata. Ezek mindegyike tartalmaz egy eredményoszlopot leíró információt: (Név,típus, display_size, belső_size, pontosság, skála, null_ok). Ez az attribútum nem lesz olyan műveleteknél, amelyek nem adnak vissza sorokat, vagy ha a kurzor még nem hívott meg műveletet a execute() módszerrel.

a típus a modul szintjén definiált adatbázistípusok egyike lesz.

Cursor.execute(utasítás, **keywordParameters) (

utasítás végrehajtása az adatbázis ellen. Lásd SQL végrehajtás.

a paraméterek átadhatók szótárként vagy szekvenciaként vagy kulcsszóparaméterként. Ha a paraméterek szótárak, akkor az értékek név szerint, ha a paraméterek szekvenciák, akkor az értékek a pozícióhoz kötődnek. Vegye figyelembe, hogy ha az értékeket pozíció köti, akkor a variables sorrendje balról jobbra van, mivel a statementand SQL utasításokat a PL/SQL utasításoktól eltérően dolgozzák fel. Ezért általában ajánlott a paramétereket név szerint kötni ahelyett, hogypozíció szerint.

szótárként átadott paraméterek név és érték párok. A név leképezi az utasítás által használt bind változó nevét, az érték pedig leképezi az adott bind változóhoz kötni kívánt python értéket.

a kurzor megőrzi az utasításra való hivatkozást. Ha nincs vagy ugyanaz a karakterlánc objektum kerül átadásra újra, a kurzor végrehajtja thatstatement újra elvégzése nélkül prepare vagy rebinding és újradefiniálása.Ez a leghatékonyabb olyan algoritmusok esetében, ahol ugyanazt az állítást használják, dekülönböző paraméterek kötődnek hozzá (sokszor). Vegye figyelembe, hogy a későbbi végrehajtások során nem átadott paraméterek megtartják az azokat tartalmazó utolsó végrehajtás során átadott értéket.

a maximális hatékonyság érdekében egy utasítás újrafelhasználásakor a legjobb, ha a setinputsizes() módszert használja a paraméterek típusainak és méreteinek idő előtti megadásához; különösen, egyik sem feltételezzük, hogy a string oflength 1 így minden olyan érték, amely később kötött számok vagy dátumok raisea TypeError kivétel.

ha az utasítás lekérdezés, akkor a kurzor kényelme érdekében visszatér a hívóhoz (így közvetlenül használható iterátorként a sorok felett a kurzorban); ellenkező esetben None kerül visszaadásra.

Cursor.executemany(utasítás, paraméterek, batcherrors=False, arraydmlrowcounts=False)!

állítson elő egy utasítást Az adatbázissal szembeni végrehajtásra, majd hajtsa végre az itagainst a sequenceparameters-ben található összes paraméter-leképezést vagy szekvenciát. Lásd: kötegelt utasítás végrehajtása és tömeges betöltése.

az utasítás kezelése ugyanúgy történik, mint a execute() módszer. Ha a pufferek mérete bármelyikhez hozzárendeltparaméterek meghaladják a 2 GB-ot, akkor a “DPI-1015″ hibát kapja: array sizeof < n>túl nagy”, ahol < n> változik a méret az egyes elemek beingallocated a puffer. Ha ezt a hibát kapja, csökkentse a számotelemek a szekvencia paraméterekben.

ha nincsenek paraméterek, vagy a paramétereket korábban kötötték, akkor az iterációk száma egész számként adható meg, ahelyett, hogy üres leképezéseket vagy szekvenciákat kellene megadnia.

ha igaz, a batcherrors paraméter lehetővé teszi a kötegelt hiba támogatását az Oracle-en belül, és biztosítja, hogy a hívás akkor is sikeres legyen, ha kivétel történik egy vagy több paramétersorozatban. A hibák ezután getbatcherrors() használatával kijavíthatók.

ha igaz, az arraydmlrowcounts paraméter lehetővé teszi a DML sorszámokat az Oracle-től a metódus befejezése után. A sorszámokat a getarraydmlrowcounts()használatával lehet letölteni.

mind a batcherrors paraméter, mind az arraydmlrowcounts paraméter csak akkor lehet igaz, ha beszúrás, frissítés, törlés vagy egyesítés utasítást hajt végre; minden más esetben hiba merül fel.

a maximális hatékonyság érdekében a legjobb, ha asetinputsizes() metódust használja a paraméterek típusainak és méreteinek idő előtti megadásához; különösen, egyik sem feltételezzük, hogy 1 hosszúságú karakterlánc, így minden olyan érték, amelyet később számként vagy dátumként kötnek össze, TypeError kivételt képez.

Cursor.executemanyprepared((numiters)

végrehajtja az előzőleg elkészített és kötött utasítást a megadott számú alkalommal. A kötött változóknak már be kell állítaniuk a kívánt értéket a hívás megkezdése előtt. Ezt a módszert arra az esetre tervezték, amikor optimális teljesítményre van szükség, mivel ez a DB API-val való kompatibilitás rovására történik.

Cursor.fetchall()¶

a lekérdezés eredményének összes (megmaradt) sorának lekérése, visszaadva őket egy listakettősként. Egy üres listát ad vissza, ha nincs több sor áll rendelkezésre. Ne feledje, hogy a kurzor arraysize attribútuma befolyásolhatja ennek a műveletnek a teljesítményét, mivel az adatbázis belső olvasása az arraysize-nek megfelelő tételekben történik.

kivétel merül fel, ha az előző hívás execute() – re nem eredményezett eredményhalmazt, vagy még nem adtak ki hívást.

lásd Fetch módszerek egy példát.

Cursor.fetchmany()¶

a lekérdezés eredményének következő sorkészletének lekérése, visszaadva a tuples.An üres lista vissza, ha nincs több sor áll rendelkezésre. Vegye figyelembe, hogy a thecursor arraysize attribútuma befolyásolhatja a művelet teljesítményét.

a beolvasandó sorok számát a paraméter határozza meg. Ha nem, akkor a kurzor arraysize attribútuma határozza meg a befetched sorok számát. Ha a lekérhető sorok száma kevesebb, mint a kért összeg, kevesebb sor kerül visszaadásra.

kivétel merül fel, ha az előző hívás execute() – re nem eredményezett eredményhalmazt, vagy még nem adtak ki hívást.

lásd Fetch módszerek egy példát.

Cursor.fetchone()¶

lekérdezés eredményhalmaz következő sorának lekérése, egyetlen tuple vagy None visszaadása, ha több adat nem áll rendelkezésre.

kivétel merül fel, ha az előző hívás execute() – re nem eredményezett eredményhalmazt, vagy még nem adtak ki hívást.

lásd Fetch módszerek egy példát.

Cursor.fetchraw()¶

a lekérdezés eredményének következő sorkészletét a Kurzorhoz definiált változók belső puffereibe töltheti be. A ténylegesen letöltött sorok számatér vissza. Ezt a módszert arra az esetre tervezték, amikor optimálisteljesítményre van szükség, mivel a DB API-val való kompatibilitás rovására történik.

kivétel merül fel, ha az előző hívás execute() – re nem eredményezett eredményhalmazt, vagy még nem adtak ki hívást.

Cursor.fetchvars¶

ez a csak olvasható attribútum a kurzoron végrehajtott utolsó lekérdezéshez létrehozott változók listáját adja meg. Óvatosan kell eljárni, amikorhivatkozás erre az attribútumra. Különösen az elemeket nem szabad eltávolítanivagy cserélni.

Cursor.getarraydmlrowcounts()¶

töltse le a DML sorszámokat a executemany()hívás után, ha az arraydmlrowcounts engedélyezve van. Ez az egész számok listáját adja vissza, amely megfelel a DML utasítás által érintett sorok számának a tömb minden eleméhez executemany().

Cursor.getbatcherrors()¶

töltse le azokat a kivételeket, amelyek aexecutemany() hívás után történtek, ha a batcherrors engedélyezve van. Ez visszaadja a Hibaobjektumok listáját, egy hibát minden sikertelen iterációhoz. Az offsetmeghatározható a hibaobjektum offset attribútumának megtekintésével.

Cursor.getimplicitresults()¶

vissza egy listát a kurzorok, amelyek megfelelnek az implicit eredmények madeavailable egy PL / SQL blokk vagy eljárás használata nélkül ki refcursor paramétereket. A PL / SQL blokk vagy eljárás megnyitja a kurzorokat ésjelzi őket, hogy visszatérjenek az ügyfélhez az proceduredbms_sql használatával.return_result. Az ilyen módon visszatért kurzorok nem lehetnekzárt. A szülő kurzor automatikusan bezárja őket, amikor bezáródik. A szülő kurzor bezárása érvényteleníti a visszaadott kurzorokatez a módszer.

Cursor.inputtypehandler¶

ez az írás-olvasás attribútum megadja a kurzoron végrehajtott utasításhoz tartozó minden érték meghívásának metódusát, és ha meg van adva, felülírja az azonos nevű attribútumot a kapcsolaton. A metódus signature ishandler (kurzor, érték, arraysize) és a visszatérési érték várhatóan avariable object vagy None lesz, ebben az esetben egy alapértelmezett változó objektum lesz létrehozva. Ha ez az attribútum nincs, akkor a kapcsolat azonos nevű attribútumának értéke kerül felhasználásra.

Cursor.__iter__()¶

visszaadja a kurzort magát kell használni, mint egy iterátor.

Cursor.lastrowid¶

ez a csak olvasható attribútum a thecursor által módosított utolsó sor sorazonosítóját adja vissza. Ha a thecursoron végrehajtott utolsó művelet nem módosította a sort, akkor a None érték kerül visszaadásra.

Cursor.outputtypehandler¶

ez az írás-olvasás attribútum megad egy metódust, amelyet minden egyes oszlophoz meg kell hívni, amelyet ebből a kurzorból kell letölteni. A metódus signature ishandler (cursor, Name, defaultType, length, precision, scale) és a returnvalue várhatóan változó objektum lesz, vagy nincs, ebben az esetben defaultvariable objektum jön létre. Ha ez az attribútum nincs, akkor a kapcsolaton azonos nevű attribútum értéke kerül felhasználásra.

lásd: beolvasott adattípusok módosítása kimeneti Típuskezelőkkel.

Cursor.parse(nyilatkozat)

ez felhasználható egy utasítás elemzésére anélkül, hogy ténylegesen végrehajtaná (ezt a lépést az Oracle automatikusan elvégzi, amikor egy utasítást végrehajtanak).

Cursor.prefetchrows¶

ez az írás-olvasás attribútum arra használható, hogy beállítsa a sorok számát, amelyeket a theOracle Client library lehív, amikor egy SELECT utasítás végrehajtásra kerül. Ez az érték csökkentheti a sorok lekéréséhez szükséges oda-vissza utak számát az adatbázisba, de további memória árán. Ha ezt az értéket 0-ra állítja, akkor hasznos lehet, ha a lekérések időzítését kifejezetten ellenőrizni kell.

további információkért lásd: Tuning Fetch Performance.

Cursor.prepare(nyilatkozat)

ez a execute() hívás előtt használható a végrehajtandó állítás meghatározására. Ha ez megtörtént, akkor a prepare fázis nem kerül végrehajtásra, ha a execute() hívást egy vagy ugyanazon string objektummal hajtják végre, mint az utasítás. Ha a megadott thestatement kerül vissza a nyilatkozatot cache az adott tag. Az utasítás gyorsítótárával kapcsolatos további információkért lásd az Oracle dokumentációját.

további információkért lásd: utasítás gyorsítótárazás.

Cursor.rowcount¶

ez a csak olvasható attribútum határozza meg a kurzorból jelenleg letöltött sorok számát (select utasításokhoz), amelyeket a művelet befolyásolt (beszúrás, frissítés, törlés és egyesítések esetén), vagy az utasítás sikeres végrehajtásainak számát(PL/SQL utasítások esetén).

Cursor.rowfactory¶

ez az írás-olvasás attribútum megadja az adatbázisból eltávolított minden sor meghívásának metódusát. Általában minden sorhoz egy tuple kerül visszaadásra, de ha ez az attribútum be van állítva, akkor a metódust azzal a tuple-vel hívják meg, amelyet általában visszaadnának, és a metódus eredményét visszaadják.

lásd: Lekérdezési eredmények módosítása Rowfactoryval.

Cursor.scroll(value=0, mode= “relative”) 6587>a kurzort az eredményben a módnak megfelelő új pozícióba kell görgetni.

ha a mód “relatív” (az alapértelmezett érték), akkor az értéket az eredményhalmaz aktuális pozíciójának eltéréseként veszi figyelembe. Ha “abszolút” értékre van állítva, az értékekabszolút célpozíciót állít be. Ha az “első” értékre van állítva, akkor a kurzor az első sorba kerül, ha pedig az “utolsó” értékre van állítva, akkor a kurzor az eredménykészlet utolsó sorába kerül.

hiba lép fel, ha a mód “relatív” vagy “abszolút”, és a görgetés a kurzort az eredményhalmazon kívülre helyezi.

Cursor.scrollable¶

ez az írás-olvasás logikai attribútum határozza meg, hogy a kurzor görgethető-e vagy sem. Alapértelmezés szerint a kurzorok nem görgethetők, mivel a kiszolgálóforrások és a válaszidők nagyobbak, mint a nem görgethető kurzorok. Ez az attribútum be van jelölve, és a megfelelő mód be van állítva az Oracle-ben, amikor a metódust execute()hívja.

Cursor.setinputsizes(*args, * * keywordArgs)

ez a execute(),callfunc() vagy callproc() hívás előtt használható a művelet paramétereinek előre meghatározott területeire. Minden paraméternek atype objektumnak kell lennie, amely megfelel a használni kívánt bemenetnek, vagy anintegernek kell lennie, megadva a karakterlánc paraméter maximális hosszát. Használja a keywordparameters-t név szerinti kötéskor, a pozicionális paramétereket pedig byposition kötéskor. A singleton None paraméterként használható, amikor a pozíciós paramétereket használja annak jelzésére, hogy az adott pozíció számára nem szabad helyet fenntartani.

Cursor.setoutputsize(size) 6587 > ez a módszer nem tesz semmit, és kizárólag a theDB API-val való kompatibilitás érdekében marad meg. A modul automatikusan annyi helyet foglal el, amennyi szükséges a hosszú és hosszú nyers oszlopok (vagy a CLOB karakterláncként és a BLOB bájtként) lekéréséhez.Cursor.statement¶

ez a csak olvasható attribútum azt a string objektumot adja meg, amelyet előzőleg prepare() – vel készítettek elő, vagyexecute() – vel hajtottak végre.

Cursor.var(adattípus)

hozzon létre egy változót a megadott jellemzőkkel. Ezt a módszert PL/SQL in/out változókkal való használatra tervezték, ahol a hossz vagy a típus nem határozható meg automatikusan a kurzorokon vagy kapcsolatokon definiált input and output típusú kezelőkben vagy foruse-ban átadott Python objektumból.

a dataType paraméter megadja, hogy milyen típusú adatokat kell tárolnia változóban. Ez legyen az egyikadatbázis típusú állandók, DB API állandók, a Connection.gettype() metódusból visszaadott objektumtípus vagy a következő Python típusok egyike:

Python Típus	Adatbázis típus
bool	cx_Oracle.DB_TYPE_BOOLEAN
bájt	cx_Oracle.DB_TYPE_RAW
datetime.dátum	cx_Oracle.DB_TYPE_DATE
datetime.datetime	cx_Oracle.DB_TYPE_DATE
datetime.timedelta	cx_Oracle.DB_TYPE_INTERVAL_DS
tizedes.Decimális	cx_Oracle.DB_TYPE_NUMBER
float	cx_Oracle.DB_TYPE_NUMBER
int	cx_Oracle.DB_TYPE_NUMBER
str	cx_Oracle.DB_TYPE_VARCHAR

a size paraméter meghatározza a string és a raw változók hosszát, és minden más esetben figyelmen kívül hagyja. Ha nincs megadva string és raw változókhoz, akkor a 4000 értéket használja a rendszer.

az arraysize paraméter meghatározza a változó elemeinek számát. Ha nincs megadva, akkor a bind tömb méretét (általában 1) kell használni. Amikor avariable jön létre egy kimeneti típus kezelő ezt a paramétert kell setto a kurzor tömb mérete.

az inconverter és outconverter paraméterek az adatbázisba/adatbázisból történő értékek konvertálásához használt módszereket határozzák meg. További információ találhatóa változó objektumokról szóló szakasz.

a typename paraméter egy SQL objektumtípus nevét adja meg, és a cx_Oracle.OBJECT típus használatakor meg kell adni, kivéve, ha a type objectwas közvetlenül az első paraméterként került átadásra.

a encodingErrors paraméter meghatározza, hogy mi történjen, ha az adatbázisból sztringekké lekérett bájtos karakterláncokat dekódolunk. Ennek az egyiknek kell lenniea builtindecodefunkcióban feltüntetett értékek.