generated from carpentries/workshop-template
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
32 additions
and
29 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,53 +1,56 @@ | ||
| <div id="sql"> | ||
| <h3>SQLite</h3> | ||
|
|
||
| <p> | ||
| SQL is a specialized programming language used with databases. We | ||
| use a database manager called | ||
| <a href="https://www.sqlite.org/">SQLite</a> in our lessons. | ||
| </p> | ||
| <ul> | ||
| <li> | ||
| SQL is a specialized programming language used with databases. We use the database manager called SQLite in our lessons. | ||
| </li> | ||
| <li> | ||
| We will use a database called Survey.db for the workshop. Download it from here: <a href="https://swcarpentry.github.io/sql-novice-survey/files/survey.db" target="_blank" rel="noopener noreferrer">https://swcarpentry.github.io/sql-novice-survey/files/survey.db</a> | ||
| and place it somewhere easily accessible on your computer, such as your document folder or desktop. It will download directly, check your downloads folder. | ||
| If you have issues downloading the file, copy and paste the url in a new browser window. | ||
| </li> | ||
| <li> | ||
| The program we will use to interact with the SQLite database is a GUI called DB Browser - see below for operating system instructions. | ||
| </li> | ||
| <li> | ||
| Note that you will require a laptop to participate in the workshop, so do the setup on a laptop you are familiar with, if you can. | ||
| </li> | ||
| </ul> | ||
|
|
||
| </p> | ||
| <div> | ||
| <ul class="nav nav-tabs" role="tablist"> | ||
| <li role="presentation" class="active"><a data-os="windows" href="#sql-windows" aria-controls="Windows" role="tab" data-toggle="tab">Windows</a></li> | ||
| <li role="presentation"><a data-os="macos" href="#sql-macos" aria-controls="MacOS" role="tab" data-toggle="tab">MacOS</a></li> | ||
| <li role="presentation"><a data-os="linux" href="#sql-linux" aria-controls="Linux" role="tab" data-toggle="tab">Linux</a></li> | ||
| <li role="presentation"><a data-os="web" href="#sql-web" aria-controls="Web" role="tab" data-toggle="tab">Web</a></li> | ||
| </ul> | ||
| <div class="tab-content"> | ||
| <article role="tabpanel" class="tab-pane active" id="sql-windows"> | ||
| <ul> | ||
| <li>Run "Git Bash" from the Start menu</li> | ||
| <li>Copy the following <code>curl -fsSL {{site.url}}{{site.baseurl}}/getsql.sh | bash</code></li> | ||
| <li>Paste it into the window that Git Bash opened. If you're unsure, ask an instructor for help</li> | ||
| <li>You should see something like <code>3.27.2 2019-02-25 16:06:06 ...</code></li> | ||
| <li>Download the <a href="https://download.sqlitebrowser.org/DB.Browser.for.SQLite-3.12.2-win64.msi">Windows installer for DB Browser</a>.</li> | ||
| <li>It will download directly, check your downloads folder and install it on your laptop.</li> | ||
| <li> | ||
| <b>NOTE:</b> If you are unable to get admin rights on your laptop, you can download a | ||
| <a href="https://sqlitebrowser.org/blog/portableapp-for-3-12-0-release-now-available/">"portable" version of DB browser</a> that does not require admin to install. | ||
| </li> | ||
| <li>But please do install the regular version of DB Browser if you can.</li> | ||
| </ul> | ||
|
|
||
| <p>If you want to do this manually, download <a href="https://www.sqlite.org/2019/sqlite-tools-win32-x86-3270200.zip">sqlite3</a>, make a bin directory in the user's home directory, unzip sqlite3, move it into the bin directory, and then add the bin directory to the path.</p> | ||
|
|
||
| </article> | ||
| <article role="tabpanel" class="tab-pane" id="sql-macos"> | ||
| <p> | ||
| SQLite comes pre-installed on macOS. | ||
| </p> | ||
| <ul> | ||
| <li>Go to the <a href="https://sqlitebrowser.org/dl/">DB Browser download page</a>.</li> | ||
| <li>Scroll down to the MacOS section and download and install the version of DB Browser that suits your mac.</li> | ||
| <li><b>NOTE:</b> If you are unsure if you have an Intel or an Apple Silicon mac, check <a href="https://support.apple.com/en-us/116943">this help page from apple</a>.</li> | ||
| </ul> | ||
| </article> | ||
| <article role="tabpanel" class="tab-pane" id="sql-linux"> | ||
| <p> | ||
| SQLite comes pre-installed on Linux. | ||
| </p> | ||
| </article> | ||
| <article role="tabpanel" class="tab-pane" id="sql-web"> | ||
| <ul> | ||
| <li>In case of problems: register for an account at <a href="https://www.pythonanywhere.com/">https://www.pythonanywhere.com</a></li> | ||
| <li>Download <a href="http://swcarpentry.github.io/sql-novice-survey/files/survey.db">survey.db</a></li> | ||
| <li>Click on files and upload survey.db</li> | ||
| <li>Click on dashboard and Choose new console <code>bash</code></li> | ||
| <li>Go to the <a href="https://sqlitebrowser.org/dl/">DB Browser download page</a>.</li> | ||
| <li>Scroll down to the Linux section.</li> | ||
| <li>Download and install the AppImage or Snap package.</li> | ||
| </ul> | ||
| </article> | ||
| </div> | ||
| </div> | ||
|
|
||
| <p><strong>If you installed Anaconda, it also has a copy of SQLite | ||
| <a href="https://github.com/ContinuumIO/anaconda-issues/issues/307">without support to <code>readline</code></a>. | ||
| Instructors will provide a workaround for it if needed.</strong></p> | ||
| </div> |