SQL-muotoilija

Näin muotoilet SQL-kyselyn

1. Liitä yksi tai useampi kysely tai napsauta Avaa tiedosto ladataksesi .sql-tiedoston (enintään 10 Mt).
2. Valitse tietokantasi Murre, esimerkiksi PostgreSQL, MySQL tai SQL Server (T-SQL).
3. Valitse, miten Avainsanat kirjoitetaan (ISOT KIRJAIMET, pienet kirjaimet tai Säilytä kirjoitettuna), sekä Sisennys.
4. Valitse Ei välilyöntejä operaattoreiden ympärillä, jos haluat muodon a=b+1 muodon a = b + 1 sijaan.
5. Napsauta Muotoile SQL ja kopioi tai lataa tulos. Asetuksen muuttaminen muotoilee kyselyn uudelleen.

Kysely vain muotoillaan tekstinä. Sitä ei koskaan suoriteta eikä lähetetä tietokantaan tai palvelimelle.

Mitä muotoilija tekee

Työkalu käyttää avoimen lähdekoodin sql-formatter-kirjastoa. Se jakaa jokaisen lauseen osiin ja sijoittaa jokaisen lausekkeen avainsanan (SELECT, FROM, WHERE, GROUP BY, ORDER BY…) omalle rivilleen niin, että osan sisältö on sisennettynä sen alla. SELECT-luettelon sarakkeet sijoitetaan yksi riviä kohti, AND- ja OR-ehdot aloittavat uudet rivit, ja alikyselyt sekä CASE-lausekkeet sisennetään sisäkkäisyystason mukaan. Lyhyet sulkulausekkeet pysyvät yhdellä rivillä. Puolipisteellä erotetut useat lauseet pidetään erillään tyhjällä rivillä.

Vain tyhjät merkit ja kirjainkoko muuttuvat. Merkkijonoliteraalit, lainausmerkeillä merkityt tunnisteet ja kommentit säilyvät täsmälleen, joten muotoiltu kysely palauttaa saman tuloksen kuin alkuperäinen.

Miksi murteella on väliä

SQL-tietokannoilla on yhteinen ydinkieli, mutta ne eroavat yksityiskohdissa, ja muotoilijan on tunnettava ne lukeakseen kyselyn oikein:

• tunnisteet merkitään lainausmerkein "kaksoislainausmerkit" standardi-SQL:ssä ja PostgreSQL:ssä, `gravis-merkit` MySQL:ssä, MariaDB:ssä ja BigQuerysta sekä [hakasulkeet] SQL Serverissä;
• operaattorit, kuten PostgreSQL:n ->> ja ::-tyyppimuunnokset tai Snowflaken :-polkuhaku, ovat olemassa vain joissakin murteissa;
• parametrien paikkamerkit vaihtelevat: ?, $1, :nimi tai @nimi;
• jokaisella murteella on omat varatut sanansa ja funktionsa, joihin Avainsanat-asetus vaikuttaa.

Jos saat ilmoituksen “Kyselyä ei voitu jäsentää”, tarkista ensin, että valittu murre vastaa tietokantaasi. Virhe näyttää rivin ja sarakkeen, johon jäsennys pysähtyi. Standardi-SQL on rajoittavin vaihtoehto; valitse mahdollisuuksien mukaan todellinen tietokantasi.

Avainsanojen kirjainkoko ja tyylivinkit

Isot kirjaimet ovat yhä yleisin käytäntö avainsanoissa, koska ne erottavat kielen taulujen ja sarakkeiden nimistä yhdellä silmäyksellä. Pienet kirjaimet ovat suosittuja tiimeissä, jotka pitävät niitä helpompina lukea, ja Säilytä kirjoitettuna jättää valintasi koskemattomaksi. Taulujen, sarakkeiden ja funktioiden nimiä ei koskaan muuteta: vain varatut avainsanat noudattavat asetusta. Pitkissä tiedostoissa yhdenmukainen muotoilu helpottaa myös versioiden välisten erojen tarkastelua huomattavasti.