Successfully reported this slideshow.
We use your LinkedIn profile and activity data to personalize ads and to show you more relevant ads. You can change your ad preferences anytime.
Upcoming SlideShare
What to Upload to SlideShare
What to Upload to SlideShare
Loading in …3
×
1 of 44

How to document database to make it more manageable

0

Share

Download to read offline

Challenges of working with databases and practical solutions how to mitigate them with documentation.

Related Books

Free with a 30 day trial from Scribd

See all

How to document database to make it more manageable

  1. 1. How to document database to make it more manageable Piotr Kononow Founder @ Dataedo https://dataedo.com
  2. 2. Challenges and Solutions https://dataedo.com
  3. 3. Build a documentation https://dataedo.com
  4. 4. Challenge 1 Where can I find this data? https://dataedo.com
  5. 5. Solution 1. Provide meaningful aliases 2. Search documentation/data catalog 3. Group objects into modules https://dataedo.com
  6. 6. Challenge 2 What are all those tables? https://dataedo.com
  7. 7. Solution Group into modules https://dataedo.com
  8. 8. Challenge 3 What is this table for? https://dataedo.com
  9. 9. Solution 1. Add meaningful title/alias 2. Assign module 3. Assign owner https://dataedo.com
  10. 10. Challenge 4 What does this table hold? https://dataedo.com
  11. 11. Challenge 4 What does this table hold? https://dataedo.com
  12. 12. Solution Add titles/aliases, descriptions https://dataedo.com
  13. 13. Challenge 5 Is this table still being used? https://dataedo.com
  14. 14. Solution Add Status field https://dataedo.com
  15. 15. Challenge 6 Who created this table? https://dataedo.com
  16. 16. Solution https://dataedo.com
  17. 17. Challenge 7 Which columns should I care about? https://dataedo.com
  18. 18. Solution Add status field https://dataedo.com
  19. 19. Challenge 8 Where this data came from? https://dataedo.com
  20. 20. Solution Add sources fields https://dataedo.com
  21. 21. Challenge 9 How to calculate this value? 1. Invoice amount – net_amount + tax 2. Order quantity? – Quantity ordered – Quantity cancelled – Quantity shipped – Quantity received 3. Order number (FK/19/01044/D)? https://dataedo.com
  22. 22. Solution Add manual (virtual) column with calculation https://dataedo.com
  23. 23. Challenge 10 What does ‘A’ value represent? https://dataedo.com
  24. 24. Solution List values with meaning in a description field https://dataedo.com
  25. 25. Challenge 11 Is there a lookup table? https://dataedo.com
  26. 26. Solution https://dataedo.com
  27. 27. Challenge 12 How to join tables? https://dataedo.com
  28. 28. Solution Document foreing keys/joins https://dataedo.com
  29. 29. Solution cntd. Define joins https://dataedo.com
  30. 30. Solution cntd. Visualize with ERDs https://dataedo.com
  31. 31. Challenge 13 What objects are used by this app? https://dataedo.com
  32. 32. Solution Create modules and assign objects https://dataedo.com
  33. 33. Solution https://dataedo.com
  34. 34. Challenge 14 Can I reuse this view? 1. What does it return? 2. What is it used for? https://dataedo.com
  35. 35. Solution 1. Provide descriptions 2. Assign module to indicate use – old and new 3. Assign owner 4. Indicate uniqueness with manual keys (PK/UK) https://dataedo.com
  36. 36. Challenge 15 Can modify this view? 1. What is it used for? 2. Who is the owner? https://dataedo.com
  37. 37. Solution 1. Provide descriptions 2. Assign module to indicate use 3. Assign owner 4. Update documentation https://dataedo.com
  38. 38. And there are many more challenges… https://dataedo.com
  39. 39. How to get started https://dataedo.com
  40. 40. How to get started 1. Install Dataedo 2. Create repository 3. Import 4. Document 5. Share https://dataedo.com
  41. 41. Document a database • Descriptions, titles and additional fields • Unique/primary keys • Foreign keys/relationships • Modules • ER diagrams
  42. 42. Questions? https://dataedo.com
  43. 43. Start today! https://dataedo.com/free-trial
  44. 44. Thank you! Piotr Kononow Founder @ Dataedo https://dataedo.com

×