SQLAlchemy

• uusia ominaisuuksia
• yleinen
• Documentation on muunnettu Sphinx. Erityisesti luotu API dokumentaatio on rakennettu täysin palanut & quot; API Reference & quot; jakso, joka järjestää toimituksellinen asiakirjat yhdistettynä syntyy docstrings. Ristisidostuskemikaalit osien välillä ja API dokumentaatio ovat huomattavasti parantunut, javascript-powered hakutoiminto on säädetty, ja täydellinen hakemisto kaikista luokista, toiminnot ja jäsenille tarjotaan.
• setup.py nyt tuo setuptools vain mahdollisesti. Jos ei ole, distutils käytetään. Uusi & quot; pip & quot; asentaja on suositeltavampaa easy_install koska se asentuu yksinkertaisempia tavalla.
• lisätään erittäin perus esimerkki PostGIS integraation esimerkkejä kansioon.
• Orm
• Query.with_polymorphic () hyväksyy nyt kolmas väite & quot; diskriminaattori & quot; joka korvaa arvo mapper.polymorphic_on kyseiselle kyselyn. Kartoittimeksi itse eivät enää vaadi polymorphic_on voidaan asettaa, vaikka merkkijonokartoitin on polymorphic_identity. Kun ei ole asetettu, mapper lataa ei-polymorfisesti oletuksena. Yhdessä nämä kaksi piirrettä mahdollistavat ei-Monimuotoinen konkreettisia perintö setup käyttää Monimuotoinen lastaus per-kyselyn pohjalta, koska betoni asetelmia ovat alttiita monille ongelmia, kun käytetään polymorfisesti kaikissa tapauksissa.
• dynamic_loader hyväksyy query_class = muokata Kyselyn luokat käytetään sekä dynaamista keräämistä ja kyselyt rakennettu sitä.
• query.order_by () hyväksyy None, joka poistaa kaikki vireillä order_by tilaan kyselyn sekä poistuisi mapitus- / suhteessa määritetty tilaus. Tämä on ensisijaisesti käyttökelpoinen pakottavista tilaaminen määritetty dynamic_loader (). [Lippu: 1079]
• sql
• RowProxy objekteja voidaan käyttää paikka sanakirjassa väitteet lähetettiin connection.execute () ja ystäviä. [Lippu: 935]
• murre
• Lisätty uusi description_encoding määrite murretta, jota käytetään koodaavat sarakkeen nimi käsiteltäessä metatiedot. Tämä yleensä oletuksena utf-8.
• mssql
• Lisätty uusi MSGenericBinary tyyppi. Tämä kartoittuu Binary tyypin niin se voi toteuttaa erikoistunut käyttäytymisen hoitoon määrittämä pituus tyyppejä kiinteävälisinä Binary tyyppejä ja ei-pituus tyyppejä kuin sitoutumattoman vaihtelevan pituinen Binary tyyppi.
• Lisätty uudenlaisten: MSVarBinary ja MSImage. [Lippu: 1249]
• Lisätty MSReal, MSNText, MSSmallDateTime, MSTime, MSDateTimeOffset ja MSDateTime2 tyypit
• sqlite
• Taulukko pohdintaa nyt tallentaa todellinen DefaultClause arvo sarakkeeseen. [Lippu: 1266]
• bugikorjauksia, käyttäytymisen muutokset
• yleinen
• Orm
• Poikkeukset esille compile_mappers () nyt säilytetään antamaan & quot; tahmea käyttäytyminen & quot;
• Jos hasattr () puhelun valmiiksi käännetty kartoitettu määrite laukaisee puuttuessa koota ja tukahduttaa poikkeus, myöhemmin kokoaminen on tukossa eikä poikkeus tulee jälleen seuraavalla koota () puhelu. Tämä ongelma esiintyy usein, kun käytät deklaratiivisten.
• property.of_type () on nyt kirjattu yhden pöydän peritäänkö tavoite, kun sitä käytetään yhteydessä prop.of_type (..). Tahansa () / on (), sekä query.join (prop. of_type (...)).
• query.join () herättää virhe, kun tavoite on liittyä ei vastaa kiinteistön perustuvan ominaisuuden
• vaikka se on epätodennäköistä, joku tekee tämän, SQLAlchemy kirjailija syyllistyi tässä loosey-goosey käyttäytymistä.
• Kiinteä vika, kun käytät weak_instance_map = False jossa modifioitu tapahtumia ei olisi siepata varten huuhtelu (). [Lippu: 1272]
• Kiinteät joitakin syvä & quot; sarake kirjeenvaihto & quot; asioita, jotka voivat vaikuttaa Kyselyn teki vastaan ​​valittavissa sisältää useita versioita samasta taulukosta, sekä ammattiliitot ja vastaavat, jotka sisälsivät saman pöydän sarakkeet eri sarakkeessa tehtävissä eri tasoilla. [Lippu: 1268]
• Custom vertailukohtaa luokkia käytetään yhdessä column_property (), suhde () jne. Voi määritellä uusia vertailun menetelmiä Vertailuryhmän, jotka tulevat saataville kautta __getattr __ () on InstrumentedAttribute. Kun kyseessä on synonyymi () tai comparable_property (), attribuutit ratkaistaan ​​ensin käyttäjän määrittämiä avainsana, sitten käyttäjän määrittämiä vertailuryhmässä.
• Lisätty ScopedSession.is_active accessor. [Lippu: 976]
• voi kulkea kartoitettu attribuutteja ja sarake esineitä avaimet query.update ({}). [Lippu: 1262]
• Mapped attribuutteja välitetään arvoja () on ekspressiotason insertin () tai päivitys () käyttää avaimia kartoitettu sarakkeita, ei että on kartoitettu määrite.
• Korjattu ongelma Query.delete () ja Query.update () ei toimi kunnolla BIND parametreja. [Lippu: 1242]
• Query.select_from (), from_statement () varmistettava, että annetaan väite on FromClause tai Teksti / Valitse / unionin vastaavasti.
• Query () voidaan siirtää & quot; komposiitti & quot; määritteen sarakkeeseen ilmaisun ja sitä laajennetaan. Jokseenkin liittyvät [lippu: 1253].
• Kysely () on hieman vakaampi kun läpäistävä erilaisia ​​sarakkeessa ilmaisut kuten jouset, clauselists, teksti (rakenteet) (joka voi tarkoittaa se vain herättää virhe kauniimmin).
• Ensimmäinen () toimii odotetusti Query.from_statement ().
• Kiinteä vika käyttöön 0.5rc4 mukana innokkaita lastaus ei toimi kohteissa, jotka lisättiin kartoittimen jälkeisen koota käyttäen add_property () tai vastaava.
• Kiinteä vika, jos monta-monta suhde () kanssa viewonly = True ei oikein viite yhteys sekun- däärinen & gt; kauko.
• Monista luettelon kohtia perustuva kokoelma säilyy antaessaan insertit & quot; keskiasteen & quot; taulukon monissa-moneen suhde. Olettaen M2M pöytä on ainutlaatuinen tai ensisijaisen avaimen rajoittaa se, tämä nostaa odotettavissa rajoite rikkoo sijaan hiljaa pudottamalla kaksoissyötteitä. Huomaa, että vanha käytös jää yksi-monta suhde koska kokoelma merkinnät tässä tapauksessa johda INSERT lausuntoja ja SQLA ei käsin poliisin kokoelmista. [Lippu: 1232]
• Query.add_column () voi hyväksyä FromClause esineitä samalla tavalla kuin session.query () voi.
• Vertailu monta-yhteen suhteessa NULL on asianmukaisesti muutettu IS NOT NULL perustuu ei _ ().
• Extra tarkastuksia lisätään varmistaa nimenomaisen primaryjoin / secondaryjoin ovat ClauseElement tapauksissa estää hämmentävää virheitä myöhemmin. [Lippu: 1087]
• Parempi mapper () tarkastaa kuin luokan luokissa. [Lippu: 1236]
• comparator_factory väite on nyt dokumentoitu, joita tuetaan kaikilla MapperProperty tyypit mukaan lukien column_property (), suhde (), backref (), ja synonyymi () [lippu: 5051].
• Vaihtoi nimeä PropertyLoader ja RelationProperty, oltava sopusoinnussa kaikkien muiden nimet. PropertyLoader on edelleen läsnä synonyyminä.
• kiinteä & quot; kaksinkertainen ITER () & quot; puhelu aiheuttaa linja virheitä sirpale API, poistetaan hairahtunut result.close () jääneet 0,4 version. [Lippu: 1099] [lippu: 1228]
• teki Session.merge Cascades ei laukaista autoflush. Korjaa sulautui tapauksissa saada ennenaikaisesti laitettu puuttuvat arvot.
• kaksi korjauksia estämään out-of-band sarakkeet renderoidaan polymorphic_union perintö skenaarioissa (joka sitten aiheuttaa ylimääräisiä taulukoita suoritetuista lausekkeesta aiheuttaa Cartesian tuotteet):
• parannuksia & quot; sarake sopeutuminen & quot; varten a- & gt; b- & gt; c perintö tilanteita paremmin paikantaa sarakkeet, jotka liittyvät toisiinsa kautta useita tasoja välillisen sijaan tekee sovitusta ei sarake.
• & quot; Monimuotoinen diskriminaattori & quot; sarake on vain suoritettu varsinaista mapitus- ollessa kyselyitä vastaan. Sarake ei & quot; vedetään & quot; alkaen alaluokan tai yläluokkaan mapitus- koska sitä ei tarvita.
• Kiinteät shard_id väitteen ShardedSession.execute (). [Lippu: 1072]
• sql
• Sarakkeet voi taas sisältää prosenttia merkkejä niiden nimet. [Lippu: 1256]
• sqlalchemy.sql.expression.Function on nyt julkinen luokka. Se voidaan subclassed tarjota käyttäjän määrittämiä SQL toiminnot välttämätöntä tyyliin, mukaan lukien ennalta vahvistettujen käyttäytymistä. Postgis.py esimerkki kuvaa yhtä käyttö tämän.
• PickleType nyt suosii == vertailun oletusarvoisesti, jos tuleva esine (esimerkiksi dict) toteuttaa __eq __ (). Jos objekti ei toteuta __eq __ () ja epävakainen = True, vähättely varoitus nostetaan.
• Kiinteät tuonti weirdness vuonna sqlalchemy.sql olemaan viedä __names__ [lippu: 1215].
• Käyttämällä samaa ForeignKey esine toistuvasti esiin virhe sijaan hiljaa ei ole myöhemmin. [Lippu: 1238]
• Lisätty NotImplementedError varten params () -menetelmää Insert / Update / Delete konstruktioita. Nämä erät eivät tällä hetkellä tue tätä toimintoa, joka myös olisi hieman harhaanjohtava verrattuna arvoihin ().
• heijastuva ulkomaiset avaimet paikantaa oikein niiden viitattu sarake, vaikka pylväs sai & quot; avaimen & quot; Yhdistän eroaa heijastuu nimi. Tämä tehdään uusi lippu ForeignKey / ForeignKeyConstraint nimeltään & quot; link_to_name & quot ;, jos True tarkoittaa etunimi on tarkoitettu-sarakkeen nimi, ei sen määritetty avain. [Lippu: 650]
• Valitse () voi hyväksyä ClauseList kuin sarakkeen samalla tavalla kuin taulukko tai muu valittavissa ja sisustus ilmaisuja voidaan käyttää sarakkeeseen elementtejä. [Lippu: 1253]
• & quot; passiivinen & quot; lippu session.is_modified () on oikein etenee määrite johtaja.
• liitto () ja union_all () ei läimäyttää mitään order_by (), joka on sovellettu valitse () s sisällä. Jos liitto () valitse () kanssa order_by () (oletettavasti tukea RAJA / offset), sinun pitäisi myös soittaa self_group () sitä sovelletaan sulkuja.
• moottori / allas
• Connection.invalidate () tarkastukset suljetun tilan välttämiseksi määrite virheitä. [Lippu: 1246]
• NullPool tukee uudelleen epäonnistumisesta käyttäytymiseen. [Lippu: 1094]
• Lisätty mutex alkuperäisen altaan perustamista käytettäessä pool.manage (dbapi). Tämä estää alaikäisen tapauksessa & quot; Dogpile & quot; käyttäytyminen, joka muutoin esiintyä raskaan kuorman käynnistyksen. [Lippu: 799]
• _execute_clauseelement () menee takaisin on oma menetelmä. Subclassing kytkentää ei tarvita nyt ConnectionProxy on käytettävissä.
• dokumentointi
• Liput [lippu: 1200] [lippu: 1149].
• Lisätty huomautus create_session () oletusasetukset.
• Lisätty osio metadata.reflect ().
• Päivitetty `TypeDecorator` osassa.
• rewrote & quot; threadlocal & quot; strategia osassa docs johtuen viime sekaannus tätä ominaisuutta.
• Poistettu pahasti vanhentunut "polymorphic_fetch" ja "select_table" docs perintöverosta, muokattu jälkipuoliskolla & quot; liittyi pöytä perintönä & quot;.
• dokumentoidut `comparator_factory` kwarg, lisätty uusia asiak kohta & quot; Custom Comparators & quot;.
• mssql
• refactored Date / Time tyyppejä. `` Smalldatetime`` tietotyyppi enää typistää sen päivämäärän vain, ja nyt kartoitetaan MSSmallDateTime tyyppi. [Lippu: 1254]
• Korjattu ongelma Numerics hyväksyä int.
• Mapped `` char_length`` on `` LEN () `` toiminnon.
• Jos `` INSERT`` sisältää alisteisen valinnan `` INSERT`` muunnetaan `` INSERT INTO VALUES`` rakentaa sen `` INSERT INTO SELECT`` konstruktio.
• Jos sarake on osa `` primary_key`` se on `` EI NULL`` koska MSSQL ei salli `` NULL`` vuonna primary_key sarakkeita.
• `` MSBinary`` nyt palauttaa `` BINARY`` sijaan `` IMAGE``. Tämä on taaksepäin yhteensopiva muutos, että `` BINARY`` on kiinteä pituus tietotyyppi taas `` IMAGE`` on vaihteleva pituus tietotyyppi. [Lippu: 1249]
• `` get_default_schema_name`` vastataan nyt tietokannasta perustuu käyttäjän oletuksena skeema. Tämä toimii vain MSSQL 2005 ja myöhemmin. [Lippu: 1258]
• Lisätty lajittelua tukea käyttämällä uutta lajittelu argumentti. Tämä on tuettu seuraavanlaisia: nieriä, NCHAR, varchar, nvarchar, tekstiä, ntext. [Lippu: 1248]
• Muutoksia yhteyden merkkijono parametrit suosivat DSN oletuksena eritelmän pyodbc. Katso mssql.py docstring yksityiskohtaiset käyttöohjeet.
• Lisätty kokeellinen tuki savepoints. Tällä hetkellä ei toimi täysin istuntoja.
• Tuki kolmella tasolla sarakkeen nullability: NULL, NOT NULL, ja tietokannan määritetty oletuksena. Oletuksena Kolumni kokoonpano (nullable = True) nyt tuottaa NULL DDL. Aiemmin ei erittely emittoitui ja tietokanta oletuksena tulisi voimaan (yleensä NULL, mutta ei aina). Nimenomaisesti pyytää tietokanta oletusarvoisesti määrittää palstoja nullable = Ei ja ei erittelyyn etenevät DDL. Tämä on taaksepäin yhteensopiva käyttäytymistä. [Lippu: 1243]
• postgres
• & quot;% & quot; merkkejä tekstissä (rakenteet) automaattisesti pakeni & quot; %% & quot ;. Koska taaksepäin yhteensopiva luonne muutoksen, varoitus vapautuu jos '%%' havaitaan merkkijono. [Lippu: 1267]
• Calling alias.execute () yhdessä server_side_cursors ei nosta AttributeError.
• Lisätty Index heijastus tukea Postgres, käyttäen suurta patch me pitkään laiminlyöty, esittämät Ken Kuhlman. [Lippu: 714]
• Oracle
• osakeantioikaistu muoto create_xid () korjaamaan kaksivaiheista sitouttamisen. Meillä on nyt kenttäraportteja Oracle kaksivaiheista sitouttamisen toimi kunnolla tämän muutoksen kanssa.
• Lisätty OracleNVarchar tyyppi, tuottaa NVARCHAR2, ja myös alaluokkien Unicode jotta convert_unicode = True oletuksena. NVARCHAR2 heijastaa tätä tyyppiä automaattisesti, joten nämä sarakkeet siirtää Unicode heijastuu pöytä ilman nimenomaista convert_unicode = True lippuja. [Lippu: 1233]
• Kiinteä vika, joka esti ulos params tietynlaisten myyntitietoja ei saatu; kiitos tonni huddlej klo wwu.edu! [Lippu: 1265]
• mysql
• & quot;% & quot; merkkejä tekstissä (rakenteet) automaattisesti pakeni & quot; %% & quot ;. Koska taaksepäin yhteensopiva luonne muutoksen, varoitus vapautuu jos '%%' havaitaan merkkijono.
• Kiinteä vian poikkeus korottaa kun FK sarakkeita ei esitellä aikana pohdintaa. [Lippu: 1241]
• Kiinteä vika liittyy heijastus kauko-skeema pöytä viiteavaimen Tuomari toiseen pöytään, että skeema.
• associationproxy
• yhdistys välityspalvelimen ominaisuudet ovat tekevät itsensä käytettävissä luokan tasolla, esimerkiksi MyClass.aproxy. Aiemmin tämä arvioitiin mitään.
• julistava
• koko argumenttiluettelossa hyväksytty merkkijono backref () sisältää "primaryjoin ',' secondaryjoin ',' toissijainen", "foreign_keys ',' remote_side ',' order_by".

Vaatimukset :

• Python