Kohdistinobjekti¶

Cursor.__enter__()¶

kursorin syöttöpiste kontekstinhallintana. Se palaa itsestään.

Cursor.__exit__()¶

kursorin poistumispiste kontekstinhallintana. Se sulkee kursorin.

Cursor.arraysize¶

tätä luku-kirjoitus-määritettä voidaan käyttää virittämään sisäisten kutsujen muodostamien ja puskuroitujen rivien määrää tietokantaan, kun haetaan rivejä SELECT statements-ja REF cursor-lausekkeista. Arvo voi merkittävästi vaikuttaa kyselyn suorituskykyyn, koska se vaikuttaa suoraan pythonin ja tietokannan välisten verkkomatkojen määrään. Menetelmissä, kutenfetchone() ja fetchall(), se ei muutu, kuinka monta riviä palautetaan sovellukseen. fetchmany() se on noudettavien rivien oletusmäärä.

suoritusetujen vuoksi oletusarvo Cursor.arraysize on 100 pistettä dB API: n suosittelemasta 1: stä. Tämä arvo tarkoittaa, että jokainen sisäinen puhelu hakee 100 riviä tietokantaan.

Katso lisätietoja Tuning Fetch Performancesta.

Cursor.bindarraysize¶

tämä luku-kirjoitus-ominaisuus määrittää sidottavien rivien määrän kerrallaan ja sitä käytetään luotaessa muuttujia kautta setinputsizes() taivar(). Se oletuksena 1 merkitys sitoa yhden rivin kerrallaan.

Cursor.arrayvar(datatyyppi, arvo)¶

luo rivimuuttuja, joka liittyy tietyn tyypin ja koon kohdistimeen, ja palauta muuttuva kohde. Arvo on joko integraattori, joka määrittää jaettavien elementtien lukumäärän, tai se on luettelo, ja jaettujen elementtien lukumäärä valitaan luettelon koosta. Jos arvo on luettelo, muuttuja asetetaan myös luettelon sisällön kanssa. Jos kokoa ei ole määritelty ja tyyppi on merkkijono tai binary, 4000 bytesis varattu. Tätä tarvitaan ryhmien siirtämiseen PL/SQL-järjestelmään (tapauksissa, joissa luettelo saattaa olla tyhjä eikä tyyppiä voida määrittää automaattisesti) tai ryhmien palauttamiseen PL/SQL-järjestelmästä.

Matriisimuuttujia voidaan käyttää vain PL / SQL-assosiatiivisissa taulukoissa, joissa on vierekkäiset avaimet. PL/SQL-assosiatiivisissa taulukoissa, joissa on harvaan asuttuja avaimia, tai taulukoissa ja sisäkkäisissä taulukoissa on käytettävä tässä otoksessa esitettyä lähestymistapaa.

Cursor.bindnames()¶

Palauta lausekkeeseen sidottujen bind-muuttujien nimet. Huomaa, että lausuma on laadittu ensin.

Cursor.bindvars¶

tämä read-only-attribuutti antaa viimeiselle muuttujalle käytetyt bind-muuttujat. Arvo on joko luettelo tai sanakirja riippuen siitä, onko Sitominen tehty aseman tai nimen perusteella. Tähän ominaisuuteen viitattaessa on noudatettava varovaisuutta. Etenkään osia ei pitäisi poistaa tai korvata uusilla.

Cursor.callfunc(name, returnType, parameters=, keywordParameters={})¶

kutsu funktiota, jolla on annettu nimi. Palautustyyppi on määritelty samassa merkintätavassa, jota setinputsizes()vaatii. Muuttujien seurannassa on oltava yksi merkintä kutakin parametria kohti, jota toiminto odottaa. Kaikki avainsanaparametrit sisällytetään jälkeen thepositional parametrit. Puhelun tulos on toiminnon palautusarvo.

katso esimerkki PL / SQL-tallennetuista funktioista.

Cursor.callproc(name, parameters=, keywordParameters = {})¶

Soita menettely etunimellä. Parametrien järjestyksessä on oltava yksi merkintä kutakin parametria kohti, jota menettely odottaa. Puhelun resultof on muunneltu kopio tulosekvenssistä. Tuloparametrit eivät ole koskemattomia; lähtö-ja tuloparametrit korvataan mahdollisesti uusilla arvoilla. Avainsanaparametrit sisällytetään jälkeen thepositional parametrit ja ei palauteta osana lähtö sekvenssi.

katso esimerkki PL / SQL – tallennetuista menettelyistä.

Cursor.close()¶

Sulje kohdistin nyt, eikä aina, kun __del__ kutsutaan. Kursori on käyttökelvoton tästä kohdasta eteenpäin; Virhepoikkeus poistetaan, jos kohdistimella yritetään tehdä mitä tahansa toimintoa.

Cursor.connection¶

tämä vain luku-attribuutti palauttaa viittauksen yhteysobjektiin, johon kohdistin luotiin.

Cursor.description¶

tämä vain luku-ominaisuus on 7-alkioisten sekvenssien sarja. Jokainen näistä tuloksista sisältää tietoa, joka kuvaa yhtä tulosaraketta: (nimi, tyyppi,display_size, internal_size, tarkkuus, mittakaava, null_ok). Tätä nimeä ei anneta operaatioille, jotka eivät palauta rivejä tai jos kohdistimeen ei ole vielä vedottu operaatioon execute() – menetelmällä.

tyyppi on yksi moduulitasolla määritellyistä tietokantatyypin vakioista.

Cursor.execute(lausunto, * * keywordparametrit)¶

Suorita lausunto tietokantaa vastaan. Katso SQL-suoritus.

parametrit voidaan siirtää sanakirjana tai sekvenssinä tai keywordparametreina. Jos parametrit ovat sanakirja, arvot sidotaan byname ja jos parametrit ovat järjestyksessä arvot sidotaan byposition. Huomaa, että jos arvot sitovat position, thevariables järjestys on vasemmalta oikealle, koska ne kohtaavat statement ja SQL lausekkeet käsitellään eri tavalla kuin PL/SQL lausekkeet. Tästä syystä on yleensä suositeltavaa sitoa parametrit nimellä insteadof sijainnin mukaan.

sanakirjana hyväksytyt parametrit ovat nimi-ja arvoparit. Nimi mapsto bind muuttuja nimi käytetään lauseke ja arvo kartat thePython arvo haluat sidottu että bind muuttuja.

kohdistin säilyttää viittauksen lauseeseen. Jos mitään tai samaa merkkijonokohdetta ei siirretä uudelleen, kursori suorittaa kyseisen lausekkeen uudelleen suorittamatta valmistelua tai uudelleensidontaa ja uudelleenmäärittelyä.Tämä on tehokkain algoritmeja, joissa käytetään samaa lausumaa, muttaErilaisia parametreja on sidottu siihen (monta kertaa). Huomaa, että parametrit, joita ei siirretä myöhempien teloitusten aikana, säilyttävät arvon, joka on laskettu viimeisen teloituksen aikana, joka sisälsi ne.

jotta lausekkeen uudelleenkäyttö olisi mahdollisimman tehokasta, on parasta käyttääsetinputsizes() – menetelmää parametrityyppien ja-koon määrittelemiseksi etukäteen; erityisesti, mikään ei oleteta olevan merkkijono oflength 1 joten kaikki arvot, jotka on myöhemmin sidottu numeroita tai päivämääriä raisea TypeError poikkeus.

jos lauseke on kysely, kursori palautetaan kätevästi thecallerille (joten sitä voidaan käyttää suoraan iteraattorina thecursorin rivien yllä); muussa tapauksessa None palautetaan.

Cursor.executemany(statement, parameters, batchervirs=False, arraydmlrowcounts=False)¶

valmistele lausuma suoritettavaksi tietokantaa vastaan ja suorita se sitten kaikkien sekvenssiarametrien parametrien tai jaksojen osalta. Katso Eräselvityksen suorittaminen ja Irtolastaus.

lausetta hallitaan samalla tavalla kuin execute() – menetelmä hallinnoi sitä. Jos koko Puskurit varattu jollekin parametrit ylittää 2 GB, saat virhe ”DPI-1015: array size of <n> is too large”, jossa <n> vaihtelee kunkin puskurissa olevan elementin koon mukaan. Jos saat tämän virheen, vähentää lukumääräelementtejä sekvenssiparametreissa.

jos muuttujia ei ole tai parametrejä on aiemmin sidottu, iteraatioiden lukumäärä voidaan määritellä kokonaislukuna sen sijaan, että täytyisi laatia luettelo tyhjistä kartoituksista tai sekvensseistä.

todenmukaisena batcherrons-parametri mahdollistaa erävirhetuen inoraclella ja varmistaa, että puhelu onnistuu, vaikka poikkeuksen tapahtuisikin yhdessä tai useammassa parametrijärjestyksessä. Virheet voidaan sitten korjata käyttämällä getbatcherrors().

jos se on totta, arraydmlrowcounts-parametri mahdollistaa DML-rivien laskemisen Oraclelta menetelmän päätyttyä. Rivi lasketaan käyttäen getarraydmlrowcounts().

sekä batcherrors-parametri että arraydmlrowcounts-parametri voivat olla totta vain suoritettaessa lisää -, päivitys -, poisto-tai yhdistämislauseketta; kaikissa muissa tapauksissa tulee esiin virhe.

parhaan hyötysuhteen saavuttamiseksi on parasta käyttääsetinputsizes() – menetelmää parametrityyppien ja-koon määrittelemiseksi etukäteen; etenkään minkään ei oleteta olevan Jono 1: stä, joten kaikki arvot, jotka sidotaan myöhemmin numeroina tai päivämäärinä, aiheuttavat poikkeuksen Tyyppivirheestä.

Cursor.executemanyprepared(

Suorita aiemmin laadittu ja sidottu lausuma annettu määrä kertoja. Sidottavien muuttujien on oltava asetettuja haluamaansa arvoon jo ennen tämän vaatimuksen esittämistä. Tämä menetelmä on suunniteltu thecase, jossa optimaalinen suorituskyky on tarpeen, koska se tulee kustannuksella ofcompatibility DB API.

Cursor.fetchall()¶

nouda kyselytuloksen kaikki (jäljellä olevat) rivit ja palauta ne ilmoitusluettelona. Tyhjä lista palautetaan, jos rivejä ei ole enempää. Huomaa, että Cursorin arraysize-attribuutti voi vaikuttaa tämän toiminnon suorituskykyyn, koska tietokannasta luetaan sisäisesti batchescorvastaten arraysizeen.

poikkeus nostetaan, jos aikaisempi kutsu execute()ei tuottanut tulosta tai soittoa ei ole vielä annettu.

katso esimerkki Noutomenetelmistä.

Cursor.fetchmany()¶

nouda kyselytuloksen seuraava rivijoukko palauttaen luettelon tuples.An tyhjä lista palautetaan, jos rivejä ei ole enempää. Huomaa, että thecursor n arraysize attribuutti voi vaikuttaa suorituskykyä tämän toiminnon.

noudettavien rivien määrä määritetään parametrin avulla. Jos se ei ole given, kursorin arraysize-attribuutti määrittää asetettavien rivien määrän. Jos haettavia rivejä on vähemmän kuin pyydetty määrä, palautetaan vähemmän rivejä.

poikkeus nostetaan, jos aikaisempi kutsu execute()ei tuottanut tulosta tai soittoa ei ole vielä annettu.

katso esimerkki Noutomenetelmistä.

Cursor.fetchone()¶

nouda kyselytulosjoukon seuraava rivi palauttaen yhden tuplen tai ei mitään, kun Tietoja ei ole enää saatavilla.

poikkeus nostetaan, jos aikaisempi kutsu execute()ei tuottanut tulosta tai soittoa ei ole vielä annettu.

katso esimerkki Noutomenetelmistä.

Cursor.fetchraw()¶

nouda seuraava kyselytulosjoukko kursorin määritettyjen muuttujien sisäisiin puskureihin. Todellisuudessa haettujen rivien määrä on palautettu. Tämä menetelmä on suunniteltu tapaukseen, jossa optimaalista suorituskykyä tarvitaan, koska se tulee kustannuksella Yhteensopivuus DB API.

poikkeus nostetaan, jos aikaisempi kutsu execute()ei tuottanut tulosta tai soittoa ei ole vielä annettu.

Cursor.fetchvars¶

tämä vain luku-attribuutti määrittää viimeisintä kyselyä varten luotujen muuttujien luettelon, joka suoritettiin kohdistimella. Tähän ominaisuuteen viitattaessa on noudatettava varovaisuutta. Etenkään osia ei pitäisi poistaa tai korvata uusilla.

Cursor.getarraydmlrowcounts()¶

nouda DML: n rivimäärät soitettaessa numeroon executemany()arraydmlrowcounts valittuna. Tämä palauttaa luettelon kokonaisluvuista, jotka vastaavat niiden rivien lukumäärää, joihin DML-lauseke vaikuttaa taulukon jokaisen osan osalta, jonka arvo on executemany().

Cursor.getbatcherrors()¶

nouda poikkeukset, jotka tapahtuivatexecutemany() soiton jälkeen eräpeilit päällä. Tämä palauttaa virheobjektien alistin, yhden virheen jokaista epäonnistunutta iteraatiota kohti. Offset voidaan määrittää tarkastelemalla virhekohteen offset-attribuuttia.

Cursor.getimplicitresults()¶

Palauta luettelo kursoreista, jotka vastaavat PL/SQL-lohkon tai menettelyn implisiittisiä tuloksia ilman REFCURSOR-parametrien käyttöä. PL / SQL-lohko tai menettely avaa kursorit ja merkitsee ne palautettavaksi asiakkaalle menettelyllä dbms_sql.return_result. Tällä tavalla palautettuja kirosanoja ei pitäisi asettaa. Ne suljetaan automaattisesti vanhemman kursorin, kun se on suljettu. Vanhemman kursorin sulkeminen mitätöi tällä menetelmällä palautetut kursorit.

Cursor.inputtypehandler¶

tämä luku-kirjoitus-attribuutti määrittää menetelmän, jota kutsutaan kullekin arvolle, joka on sidottu kohdistimeen suoritettuun lausekkeeseen, ja ohittaa attribuutin, jossa on sama nimi, jos se on määritetty. Menetelmän allekirjoitus ishandler (kursori, arvo, arraysize) ja palautusarvo ovat avariable objekti tai ei mitään, jolloin oletusmuuttuja objekti luodaan. Jos tämä attribuutti ei ole mikään, käytetään attribuutin arvoa, jonka yhteydessä on sama nimi.

Cursor.__iter__()¶

palauttaa itse kursorin käytettäväksi iteraattorina.

Cursor.lastrowid¶

tämä read-only-attribuutti palauttaa thecursorin muokkaaman viimeisen rivin rivid-arvon. Jos viimeinen toiminto thecursorissa ei ole muuttanut riviä, arvoa ei palauteta.

Cursor.outputtypehandler¶

tämä luku-kirjoitus-attribuutti määrittää menetelmän, jota kutsutaan kullekin sarakkeelle, joka haetaan tästä kohdistimesta. Menetelmän allekirjoitus ishandler (kursori, nimi, defaultType, pituus, tarkkuus, asteikko) ja returnvalue ovat muuttuva objekti tai ei mitään, jolloin defaultvariable objekti luodaan. Jos tämä attribuutti ei ole yhtään, käytetään sen sijaan attribuutin arvoa, jolla on sama nimi yhteydessä.

Katso noudettujen tietotyyppien muuttaminen Tulostyypin käsittelijöillä.

Cursor.parse(lausuma)¶

tätä voidaan käyttää lausuman jäsentämiseen ilman varsinaista toteutusta (Oracle tekee tämän automaattisesti, kun lausuma suoritetaan).

Cursor.prefetchrows¶

tätä luku-kirjoitus-määritettä voidaan käyttää niiden rivien virittämiseen, jotka theOracle-Asiakaskirjasto hakee SELECT-lausekkeen suorituksen yhteydessä. Tämä arvo voi vähentää edestakaisia matkoja tietokantaan, jotka ovat tarpeen hakea rivejä, mutta kustannuksella lisämuistia. Tämän arvon asettaminen arvoon 0 voi olla hyödyllistä, kun hakemusten ajoitusta on valvottava yksiselitteisesti.

Katso lisätietoja Tuning Fetch Performancesta.

Cursor.prepare(lausuma)¶

tätä voidaan käyttää ennen kehotusta execute() määrittelemään lausuma, joka toteutetaan. Tällöin valmisteluvaihetta ei suoriteta, kun kutsu execute() soitetaan yhdellä tai samalla merkkijonolla kuin lausuma. Jos määritetty, lausuma palautetaan lausuman välimuistiin annetulla tagilla. Katso Oraclen dokumentaatio saadaksesi lisätietoa tiliotteen välimuistista.

Katso lisätietoja lausekkeen välimuistiin tallentamisesta.

Cursor.rowcount¶

tämä vain luku-ominaisuus määrittää niiden rivien määrän, jotka on tällä hetkellä noudettu kohdistimesta (valituille lausekkeille) ja joihin toiminto on vaikuttanut (Lisää, päivitä, poista ja mergestatements), tai lausekkeen onnistuneiden suoritusten määrän(PL/SQL-lausekkeille).

Cursor.rowfactory¶

tämä read-write-attribuutti määrittää menetelmän, jota käytetään jokaisen tietokannasta poistetun rivin osalta. Tavallisesti tuple palautetaan jokaiselle riville, mutta jos tämä ominaisuus on asetettu, menetelmää kutsutaan sellaisella tuplalla, joka normaalisti palautetaan, ja menetelmän tulos palautetaan toisin päin.

Katso muuttuvat kyselytulokset Rivitoimituksilla.

Cursor.scroll(value=0, mode= ”relative”)¶

Vieritä tulosjoukossa olevaa kursoria uuteen asentoon themoden mukaisesti.

jos moodi on ”suhteellinen” (oletusarvo), arvoa pidetään tulosjoukon nykyisen position ylittävänä arvona. Jos arvo on ”absoluuttinen”, arvo määrittää absoluuttisen kohdepaikan. Jos asetetaan ”ensimmäiselle”, kohdistin asetetaan ensimmäiselle riville ja jos asetetaan ”viimeiselle”, kohdistin asetetaan tulosjoukon viimeiselle riville.

virhe nostetaan, jos tila on ”suhteellinen” tai ”absoluuttinen” ja vieritystila asettaisi kursorin tulosjoukon ulkopuolelle.

Cursor.scrollable¶

tämä luku-Kirjoita boolean-attribuutti määrittää, voidaanko kohdistin kääntää vai ei. Oletusarvoisesti kursorit eivät ole vieritettäviä, koska palveluresurssit ja vasteajat ovat suuremmat kuin ei-kirjattavat kursorit. Tämä attribuutti tarkistetaan ja vastaava tila asetetaan Oraclessa, kun kutsutaan menetelmää execute().

Cursor.setinputsizes(*args, * * keywordArgs)¶

tätä voidaan käyttää ennen soittoa numeroon execute(),callfunc() tai callproc() ennen kuin operaation parametrit määritellään. Jokaisen parametrin tulee olla atype-objekti, joka vastaa käytettävää syöttöä, tai sen tulee olla aninteger, joka määrittää merkkijonoparametrin enimmäispituuden. Käytä keywordparameters kun sitova nimi ja sijaintiparametrit kun sitova byposition. Singletonia ei voida käyttää parametrina, kun käytetään posionaalisia parametrejä osoittamaan, että kyseiselle positiolle ei pitäisi varata tilaa.

Cursor.setoutputsize(koko)¶

tämä menetelmä ei tee mitään ja se säilytetään ainoastaan yhteensopivuuden vuoksi THEDB API: n kanssa. Moduuli jakaa automaattisesti niin paljon tilaa kuin tarvitaan pitkille ja pitkille RAW-sarakkeille (tai CLOB: lle merkkijonona ja BLOB: lle tavuina).

Cursor.statement¶

tämä vain luku-attribuutti antaa merkkijonon objektin, joka on aiemmin preparoitu arvolla prepare() tai suoritettu arvollaexecute().

Cursor.var(datatyyppi)¶

luo muuttuja, jolla on määritellyt ominaisuudet. Tämä menetelmä suunniteltiin käytettäväksi PL/SQL in / out-muuttujien kanssa, joissa pituus tai tyyppi ei voida määrittää automaattisesti Python-objektista, joka välitetään sisään tai käytetään input-ja output-tyyppisissä käsittelijöissä, jotka on määritelty kursoreissa tai yhteyksissä.

datatype-parametri määrittää muuttujaan tallennettavien tietojen tyypin. Tämän tulisi olla jokin thedatabase – tyypin vakioista, DB API-vakioista, menetelmällä palautettu oliotyyppi Connection.gettype() tai jokin seuraavista Python-tyypeistä:

Python-Tyyppi	Tietokantatyyppi
bool	cx_Oracle.DB_TYPE_BOOLEAN
tavua	cx_Oracle.DB_TYPE_RAW
päiväysaika.päiväys	cx_Oracle.DB_TYPE_DATE
päiväysaika.päivämäärä	cx_Oracle.DB_TYPE_DATE
päiväysaika.timedelta	cx_Oracle.DB_TYPE_INTERVAL_DS
desimaali.Desimaali	cx_Oracle.DB_TYPE_NUMBER
float	cx_Oracle.DB_TYPE_NUMBER
int	cx_Oracle.DB_TYPE_NUMBER
str	cx_Oracle.DB_TYPE_VARCHAR

kokoparametri määrittää merkkijonon ja raw-muuttujien pituuden ja on merkitty kaikissa muissa tapauksissa. Jos merkkijonoja ja raakoja muuttujia ei ole määritetty,käytetään arvoa 4000.

arraysize-parametri määrittää muuttujan elementtien lukumäärän. Jos ei ole määritelty bind array koko (yleensä 1) käytetään. Kun avariable luodaan tulostetyyppikäsittelijässä, tämän parametrin tulee määrittää kohdistimen ryhmäkoko.

inconverter – ja outconverter-parametrit määrittelevät menetelmät, joita käytetään arvojen muuntamisessa tietokantaan/tietokannasta. Lisätietoa löytyy muuttuvia objekteja käsittelevästä osiosta.

typename-parametri määrittää SQL-objektityypin nimen, ja se on yksilöitävä, kun käytetään tyyppiä cx_Oracle.OBJECT, ellei tyyppi Object välitetty suoraan ensimmäisenä parametrina.

encodingerries-parametri määrittää, mitä tapahtuu, kun tietokannasta haetut Byte-merkkijonot dekoodataan merkkijonoiksi. Sen pitäisi olla yksi arvoista totesi rakennettuindecodefunction.