Opened 9 years ago

Closed 9 years ago

Last modified 9 years ago

#26371 closed New feature (worksforme)

please add section to tutorial for switching over to and using postgres

Reported by: Becka R. Owned by: nobody
Component: Documentation Version: 1.9
Severity: Normal Keywords:
Cc: Triage Stage: Unreviewed
Has patch: no Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: yes UI/UX: no

Description (last modified by Tim Graham)

Because it is not possible to deploy Django with SQLite, the tutorial would be much more complete with a section for "beyond the basics."

I now have a solid understanding of the fundamentals, and have been struggling a lot to level up, and there are a lot of common use cases which are insufficiently documented.

In a "beyond the basics" tutorial section, one chapter might include step by step instructions for moving over to Postgres using Psycopg2, and then using multiple settings files depending on the dev context, and understanding how to navigate this (honestly, I'm not even sure what questions to ask here, because I barely understand how it works).

On some platforms, it is not possible to deploy with SQLite. Generally speaking, SQLite isn't the favored database for deployed applications.

It's very, very easy to make mistakes here, and the documentation for the psycopg2 package itself is inaccurate, and the docs for Postgres are overwhelming. The combination of Django and Postgres to the new dev feels very, very insurmountable without a pairing buddy. Please add docs to add support for this very standard and confusing process.

Change History (4)

in reply to:  description ; comment:1 by Claude Paroz, 9 years ago

Resolution: worksforme
Status: newclosed

Replying to beckastar:

Because it is not possible to deploy Django with SQLite, the tutorial would be much more complete with a section for "beyond the basics."

Where did you read this? It is not recommended on most real deployments, but I'm using Django/SQLite on a very small site and I'm satisfied for that specific use case.

I wouldn't say that we couldn't improve anything on this subject, but your description of the issue is not very targeted and I'm afraid it would be difficult to turn it into a real patch. It could be the subject of a discussion in a sprint or something like that. I'd then suggest to open a ticket with some proposal attached.

in reply to:  1 comment:2 by Becka R. , 9 years ago

Component: UncategorizedDocumentation
Description: modified (diff)

(edited description in response to Claude's comment)

Last edited 9 years ago by Tim Graham (previous) (diff)

comment:3 by Tim Graham, 9 years ago

Description: modified (diff)
Type: UncategorizedNew feature

comment:4 by Tim Graham, 9 years ago

I think there are other excellent resources on the net with more details about using PostgreSQL (such as the Django Girls tutorial) and I don't see a big need to duplicate this information in Django's docs.

As for the point about using multiple settings files to connect to different databases, this goes against the recommendation to use the same database for development and production:

If you are developing a simple project or something you don’t plan to deploy in a production environment, SQLite is generally the simplest option as it doesn’t require running a separate server. However, SQLite has many differences from other databases, so if you are working on something substantial, it’s recommended to develop with the same database as you plan on using in production.

Note: See TracTickets for help on using tickets.
Back to Top