30.06.2013 Views

SQL Server Team-based Development - Red Gate Software

SQL Server Team-based Development - Red Gate Software

SQL Server Team-based Development - Red Gate Software

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

Table of Contents<br />

Introduction .................................................................................. xiii<br />

Chapter 1: Writing Readable <strong>SQL</strong> ................................................. 16<br />

Why Adopt a Standard? .........................................................................................................16<br />

Object Naming Conventions ................................................................................................18<br />

Tibbling...............................................................................................................................18<br />

Pluralizing..........................................................................................................................19<br />

Abbreviating.(or.abrvtng).................................................................................................19<br />

[Escaping].......................................................................................................................... 20<br />

Restricting..........................................................................................................................22<br />

A.guide.to.sensible.object.names...................................................................................23<br />

Code Layout ............................................................................................................................26<br />

Line-breaks........................................................................................................................ 26<br />

Indenting............................................................................................................................27<br />

Formatting.lists.................................................................................................................27<br />

Punctuation...................................................................................................................... 28<br />

Capitalization................................................................................................................... 29<br />

Getting.off.the.fence….................................................................................................... 30<br />

Summary ..................................................................................................................................34<br />

Chapter 2: Documenting your Database .....................................36<br />

Why Bother to Document Databases? ................................................................................36<br />

Where the Documentation Should Be Held ......................................................................37<br />

What Should Be In the Documentation? ...........................................................................39<br />

How Should the Documentation Be Published? ...............................................................39<br />

What Standards Exist? .......................................................................................................... 40<br />

XMLDOCS........................................................................................................................40<br />

YAML.and.JSON.............................................................................................................. 44<br />

How Headers are Stored in the Database .......................................................................... 46<br />

Extended.properties........................................................................................................ 47<br />

Get Information Out of Headers ......................................................................................... 51

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!