mirror of https://github.com/nocodb/nocodb
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Tree:
109f79059e
1-command-setup
DarkPhoenix2704-patch-1
auto-upstall-docs
chore/fix/rr
chore/pr-build-action
chore/release-tag-creation
chore/upstall-default-val-init
codecov_istanbul
del-mssql-support
dependabot/npm_and_yarn/axios-0.28.0
dependabot/npm_and_yarn/body-parser-1.20.3
dependabot/npm_and_yarn/happy-dom-15.10.2
dependabot/npm_and_yarn/nanoid-3.3.8
dependabot/npm_and_yarn/nuxt-3.12.4
dependabot/npm_and_yarn/packages/nc-cli/multi-6bc014718a
dependabot/npm_and_yarn/packages/noco-docs/cross-spawn-7.0.6
dependabot/npm_and_yarn/packages/noco-docs/http-proxy-middleware-2.0.7
dependabot/npm_and_yarn/packages/noco-docs/multi-9f37c16f8f
dependabot/npm_and_yarn/packages/noco-docs/multi-cf87d80143
dependabot/npm_and_yarn/packages/noco-docs/multi-d66d039ac5
dependabot/npm_and_yarn/packages/noco-docs/nanoid-3.3.8
develop
feat/0523-export-schema
feat/4050-custom-page-size-option
feat/after-login-navigate-to-req-page
feat/better-sqlite3
feat/button
feat/enable-disable-audit-log
feat/export
feat/export-nest
feat/export-nest-dir-restructure
feat/export-nest-pw
feat/local-export
feat/migration-enhancements
feat/node-20
feat/oracle
feat/oracle-support
feat/pdf-export
feat/select-column
feat/socket-api
feat/sortable-project-list
feat/ssr-storage
feat/user-avatar-and-ui-imporovements
fix/3416-deleting-active-tab
fix/4708-invite-only-signup
fix/8667-wh-pay
fix/comments-added-through-api-token-request-cannot-be-displayed
fix/csv-upload-into-field-set-to-duration-fails
fix/docs-shots
fix/form-complete
fix/heroku-bugs
fix/mssql-text-ntext
fix/mysql-big-int
fix/override-id
fix/save-rows-on-tab-switch
fix/show-tooltip-on-truncate
fix/sn-sf
fix/src-filter
master
nc-agg/tests
nc-cal/corrections
nc-chore-build
nc-chore/concurrency
nc-chore/remove-signout-admin-page
nc-enable-calendar-view
nc-expand-rows
nc-feat-world-clock-extension
nc-feat/ai-fill-poc
nc-feat/amplify
nc-feat/attachment-clean-up
nc-feat/custom-url-support-for-shared-base-view
nc-feat/dbricks-v3
nc-feat/enable-thumbnail-migration
nc-feat/expanded-form-discussion-mode
nc-feat/extension-tests
nc-feat/extensions
nc-feat/group-by
nc-feat/mfe-show-system-fields
nc-feat/number-format-on-rollup
nc-feat/open-base-table-view-in-new-tab
nc-feat/percent-field-v2
nc-feat/test-data-api-v3
nc-feat/user-profile-icon
nc-feat/xc-auth-throttler
nc-fix-infinite-scolll
nc-fix-warning
nc-fix/admin-panel-ui-changes
nc-fix/at-attachments
nc-fix/ci-hang
nc-fix/cmdk-ws-2
nc-fix/date-picker
nc-fix/delay-formula-type-reset-till-saving
nc-fix/dev-merge-conflict
nc-fix/duplicate-code
nc-fix/error-handling
nc-fix/extension-misc
nc-fix/fields-menu-improvement
nc-fix/file-mode-changes
nc-fix/graceful-worker
nc-fix/inline-table-rename
nc-fix/invalid-formula-duplicate
nc-fix/json-clamp
nc-fix/list-api-bugs
nc-fix/lock-view-and-add-new-row-ex-db
nc-fix/lookup
nc-fix/merge-conflict
nc-fix/meta-first
nc-fix/missing-is-ui-allowed-def
nc-fix/nc-dropdown-default-placement
nc-fix/pubsub
nc-fix/redirect-after-signin
nc-fix/rollup-fixes
nc-fix/slt-single-select-conversion
nc-fix/test-cal
nc-fix/thumbnail-worker
nc-fix/update-table-icon
nc-fix/wh-followup
nc-nc-expand-rows
nc-node-20
nc-oss/44517c26
nc-oss/8fbb4681
nc-oss/f4dcddf8
nc-refactor/nc-select
nc-refactor/rename-to-base-and-src
nc-refactor/source-table-name-migration
nc-refactor/swagger-api
nc-revert-2521-feat/share-ui
nc-revert-4100-revert-4017-feat/expanded-records-presentors
nc-row-reorder
nc-rspack-swc
nc/6a3df5e9
nc/c8f13f67
pr-4468-qr-code-extraction
refactor/icons-update
refactor/knex-timeout
refactor/missing-events
refactor/rename-meta-tables
refactor/ui-updates
refactor/upgrader
renovate/major-major
renovate/minor
renovate/npm-axios-vulnerability
renovate/npm-express-vulnerability
renovate/npm-happy-dom-vulnerability
renovate/npm-mysql2-vulnerability
renovate/npm-nanoid-vulnerability
renovate/npm-run-all-replacement
renovate/npm-vue-i18n-vulnerability
renovate/patch-patch
s3-endpoint
sync
test/0525-tz2
test/all-db-test
test/develop-reset-pass
test/ncv2-verification-suite
test/percent
test/project-delete-pw-inconsistency
test/pw-duplicate-check
test/query-opt-imp
test/quick-run
test/reset-fail
test/sample-code
test/shardx2
test/shared-form-select-field
test/skip-remove-user-test
test/ut-fix
update-readme-3
upstream-auto-upstall-minio
0.10.0
0.10.1
0.10.2
0.10.3
0.10.4
0.10.5
0.10.6
0.100.0
0.100.1
0.100.2
0.100.2-finn.0
0.100.2-finn.0-alpha
0.100.2-finn.1
0.100.2-finn.1-alpha
0.101.0
0.101.0-beta.0
0.101.2
0.104.1
0.104.2
0.104.3
0.105.0
0.105.1
0.105.2
0.105.3
0.106.0
0.106.0-beta.0
0.106.0-beta.1
0.106.1
0.107.0
0.107.0-beta.0
0.107.0-beta.1
0.107.1
0.107.2
0.107.3
0.107.4
0.107.5
0.108.0
0.108.0-beta.0
0.108.1
0.109.0
0.109.1
0.109.2
0.109.3
0.109.4
0.109.5
0.109.6
0.109.7
0.11.0
0.11.1
0.11.10
0.11.11
0.11.12
0.11.13
0.11.14
0.11.15
0.11.16
0.11.17
0.11.18
0.11.19
0.11.20
0.11.21
0.11.22
0.11.23
0.11.24
0.11.25
0.11.26
0.11.28
0.11.29
0.11.3
0.11.30
0.11.31
0.11.32
0.11.33
0.11.34
0.11.36
0.11.39
0.11.4
0.11.40
0.11.41
0.11.42
0.11.43
0.11.44
0.11.45
0.11.46
0.11.5
0.11.6
0.11.7
0.11.8
0.11.9
0.111.0
0.111.1
0.111.2
0.111.3
0.111.4
0.200.0
0.202.0
0.202.10
0.202.4
0.202.5
0.202.6
0.202.7
0.202.8
0.202.9
0.203.0
0.203.1
0.203.2
0.204.0
0.204.1
0.204.2
0.204.3
0.204.4
0.204.5
0.204.6
0.204.7
0.204.8
0.204.9
0.205.0
0.205.1
0.207.0
0.207.1
0.207.2
0.207.3
0.250.0
0.250.1
0.250.2
0.251.0
0.251.1
0.251.2
0.251.3
0.252.0
0.253.0
0.255.0
0.255.1
0.255.2
0.256.0
0.257.0
0.257.2
0.258.0
0.258.1
0.258.10
0.258.2
0.258.3
0.4.5
0.4.8
0.4.9
0.80.0
0.81.0
0.81.1
0.82.0
0.82.0-finn.1
0.83.0
0.83.1
0.83.2
0.83.3
0.83.4
0.83.5
0.83.5-finn.0
0.83.5-finn.1
0.83.5-finn.2
0.83.6
0.83.8
0.84.1
0.84.10
0.84.10-finn.0
0.84.10-finn.2
0.84.10-finn.3
0.84.10-finn.6
0.84.12
0.84.13
0.84.13-finn.3
0.84.13-finn.4
0.84.13-finn.5
0.84.14
0.84.14-finn.3
0.84.14-finn.5
0.84.14-finn.6
0.84.14-finn.7
0.84.15
0.84.16
0.84.2
0.84.3
0.84.6
0.84.7
0.84.8
0.84.8-finn.2
0.84.8-finn.3
0.84.9
0.9
0.90.0
0.90.1
0.90.10
0.90.10-finn.0
0.90.10-finn.1
0.90.11
0.90.2
0.90.3
0.90.4
0.90.5
0.90.7
0.90.8
0.90.9
0.91.0
0.91.1
0.91.10
0.91.6
0.91.7
0.91.7-finn.0
0.91.8
0.91.9
0.92.0
0.92.0-finn.0
0.92.0-finn.1
0.92.1
0.92.1-finn.0
0.92.1-finn.1
0.92.1-finn.10
0.92.1-finn.3
0.92.1-finn.4
0.92.1-finn.5
0.92.1-finn.6
0.92.1-finn.7
0.92.1-finn.8
0.92.1-finn.9
0.92.2
0.92.3
0.92.4
0.92.4-finn.0
0.92.4-finn.1
0.92.4-finn.1-beta
0.92.4-finn.2
0.92.4-finn.2-beta
0.92.4-finn.3
0.92.4-finn.4
0.92.4-finn.5
0.92.4-finn.6
0.92.4-finn.7
0.96.0
0.96.1
0.96.2
0.96.4
0.97.0
0.97.0-finn.0
0.97.0-finn.0-beta
0.97.0-finn.1
0.97.0-finn.2
0.97.0-finn.3
0.97.0-finn.3-beta
0.97.0-finn.4
0.97.0-finn.5
0.97.0-finn.6
0.97.0-finn.6-beta
0.97.0-finn.7-beta
0.98.1
0.98.1-finn.0
0.98.1-finn.1
0.98.1-finn.2
0.98.2
0.98.3
0.98.3-finn.0
0.98.3-finn.0-beta
0.98.3-finn.1-beta
0.98.3-finn.2
0.98.3-finn.2-alpha
0.98.3-finn.2-gamma
0.98.3-finn.3
0.98.4
0.98.4-finn.0-alpha
0.98.4-finn.1
0.98.4-finn.2
0.98.4-finn.3
0.98.4-finn.4
0.99.0
0.99.1
0.99.2
crea
v0.10.0
v0.4.2
v0.4.4
v0.9.41
${ noResults }
nocodb/packages/noco-docs/versioned_docs/version-0.109.7/030.setup-and-usages/020.table-operations.md
193 lines
10 KiB
193 lines
10 KiB
---
|
|||
|
title: "Table Operations"
|
||
|
description: "Table Operations: Row, Column, Quick Import, Export & Import"
|
||
---
|
|||
|
|||
Once you have created a new NocoDB project you can open it, In the browser, the URL would be like `example.com/#/default/<project_id>`.
|
|||
|
|||
|
## Table
|
||
|
|||
### Table Create
|
|||
|
|||
On project dashboard, click on `Add new table` button
|
|||
|
|||
![table-create-button](https://github.com/nocodb/nocodb/assets/86527202/0b1d0b89-b3c6-4c3c-8208-4b6afce67d23)
|
|||
|
|||
Provide a name for the table & click `Create Table` button.
|
|||
|
|||
![table-create-modal](https://github.com/nocodb/nocodb/assets/86527202/fceb6c48-e0d6-428c-bb16-d2da4e38a81f)
|
|||
|
|||
|
|||
After the successful submission, the table will be created and open on a new grid.
|
|||
|
|||
<img width="1504" alt="image" src="https://user-images.githubusercontent.com/35857179/194795081-f41ebd4d-7fa9-4f65-a66f-3d2375925106.png" />
|
|||
|
|||
### Table Rename
|
|||
|
|||
|
Right click on Table name on left hand project-tree menu, select `Rename`
|
||
|
|||
<img width="606" alt="image" src="https://user-images.githubusercontent.com/35857179/194795096-82b007fb-f57a-4141-938e-be502b1fb2cd.png" />
|
|||
|
|||
|
In modal popup, enter new table name and click `Submit` button
|
||
|
|||
<img width="1506" alt="image" src="https://user-images.githubusercontent.com/35857179/194795119-4aeb05e1-16d5-4b4f-bf6c-81752234d946.png" />
|
|||
|
|||
### Table Delete
|
|||
|
|||
Right click on Table name on left hand project-tree menu, select `Delete`
|
|||
|
|||
<img width="641" alt="image" src="https://user-images.githubusercontent.com/35857179/194795140-4fe71896-0802-45dd-9c93-64e51925be57.png" />
|
|||
|
|||
Click Yes to confirm the table deletion
|
|||
|
|||
<img width="1507" alt="image" src="https://user-images.githubusercontent.com/35857179/194795152-9bdbf8df-846e-42f3-89d0-c68bce022cc1.png" />
|
|||
|
|||
|
## Column
|
||
|
|||
### Column Add
|
|||
|
|||
|
Click the `+` icon on the right corner of the table.
|
||
|
|||
<img width="352" alt="image" src="https://user-images.githubusercontent.com/35857179/189053971-a3d29b3b-1177-49fe-8178-8868528fe3e7.png" />
|
|||
|
|||
After the click, it will show a menu and you can enter the column name and choose the column type. (See [Column Types](./column-types) for the full list).
|
|||
|
|||
<img width="459" alt="image" src="https://user-images.githubusercontent.com/35857179/189073266-a0f19e2e-5dd2-4343-8c74-4ef709da272c.png" />
|
|||
|
|||
You can also click `Show more` for additional menu options.
|
|||
|
|||
|
![Screenshot 2023-03-03 at 8 13 07 PM](https://user-images.githubusercontent.com/86527202/222749857-0e793db2-a5d2-4b54-8d23-2a0cbbec8f5d.png)
|
||
<!-- <img width="445" alt="image" src="https://user-images.githubusercontent.com/35857179/189075678-d18b799f-df13-4f78-a5a5-813e8d3277ae.png" /> -->
|
|||
|
|||
Click `Save` button to create the new column.
|
|||
|
|||
<img width="1509" alt="image" src="https://user-images.githubusercontent.com/35857179/194795274-08483315-5538-4685-8c08-261a9c2dfe14.png" />
|
|||
|
|||
### Column Edit
|
|||
|
|||
To edit column properties, click the down arrow, select `Edit` from the menu.
|
|||
|
|
||
<img width="230" alt="image" src="https://user-images.githubusercontent.com/35857179/189077129-dfb7a815-3fc7-41ea-b72c-e57f3c30a7f4.png" />
|
|||
|
|
||
You will be able to edit column name & associated datatype using pop-up modal. You can also click `Show more` for additional menu options.
|
|||
|
|
||
<img width="497" alt="image" src="https://user-images.githubusercontent.com/35857179/189077270-7acdc818-3747-4307-93fb-e970cb7936f9.png" />
|
|||
|
|||
|
Prior to v0.104.3, Advanced menu by default displayed developer specific database configuration options. To avoid unintended tweaks from user, these are now hidden under an easter egg menu. To enable, double click on `show all`/`hide all` button in column edit modal.
|
||
|
|||
![Screenshot 2023-03-06 at 10 45 26 AM](https://user-images.githubusercontent.com/86527202/223024810-85dac1c6-87ef-4193-90cb-3a05be8ccc1d.png)
|
|||
|
|||
|
|||
### Column Delete
|
|||
|
|||
To delete a column, click the down arrow, select `Delete` from the menu.
|
|||
|
|||
<img width="256" alt="image" src="https://user-images.githubusercontent.com/35857179/189077566-c9376e4e-9ee8-4ffa-b437-1240894a30cd.png" />
|
|||
|
|||
Click `Yes` to confirm the column deletion.
|
|||
|
|||
<img width="1507" alt="image" src="https://user-images.githubusercontent.com/35857179/194795311-c2a5587e-d92f-4b88-a8a3-e20ac13c694b.png" />
|
|||
|
|||
|
## Row
|
||
|
|||
|
For adding new values to the table we need new rows, new rows can be added in two methods.
|
||
|
|||
### Row Add (Using Form)
|
|||
|
|||
|
- Click the `+` icon in the toolbar of the table tab.
|
||
<img width="1038" alt="image" src="https://user-images.githubusercontent.com/35857179/189079143-8f3e3dd6-9b62-4fb0-9a78-a57545026d11.png" />
|
|||
- Then you can enter the values and click `Save row`.
|
|||
<img width="1506" alt="image" src="https://user-images.githubusercontent.com/35857179/194795353-2d90316f-a5e4-41af-8931-20b3c6ed08dc.png" />
|
|||
|
- After saving it will be there on your table.
|
||
<img width="620" alt="image" src="https://user-images.githubusercontent.com/35857179/194795402-d7c26ced-a009-43d9-a4a4-e3c2653225f0.png" />
|
|||
|
|||
### Row Add (Using Table Row at bottom of page)
|
|||
|
|||
- Click the bottom row of the table `+ Add new row`.
|
|||
<img width="545" alt="image" src="https://user-images.githubusercontent.com/35857179/189079815-9a7ea5e3-4eb7-452e-99a8-78c271f2ad1f.png" />
|
|||
- A new empty row will be created
|
|||
<img width="567" alt="image" src="https://user-images.githubusercontent.com/35857179/189080009-3aeb70b4-92b0-4702-acb9-e5e52e31855e.png" />
|
|||
|
|||
|
### Row Add (Pressing Enter Key from Previous Row)
|
||
|
|||
When you finish editing a cell and press Enter, the cell in the next row with the same column will be highlighted.
|
|||
|
|||
![image](https://user-images.githubusercontent.com/35857179/203271676-bab64ca4-e0e4-4deb-9a62-609a97158911.png)
|
|||
|
|||
### Row Edit
|
|||
|
|
||
|
You can start editing by any of the following methods
|
||
- Double click on cell to edit
|
|||
- Click on cell and start typing (this way it will clear the previous content)
|
|||
|
- Click on cell and press enter to start editing
|
||
- And it will automatically save on blur event or if inactive.
|
|||
|
|||
### Row Delete
|
|||
|
|||
|
Right-click on anywhere in the row and then from the context menu select `Delete Row` option.
|
||
|
|
||
Bulk delete is also possible by selecting multiple rows by using the checkbox in first column and then `Delete Selected Rows` options from the right click context menu.
|
|||
|
|||
<img width="568" alt="image" src="https://user-images.githubusercontent.com/35857179/189081764-9f13c286-e02a-40d0-93ea-4b1362d96827.png" />
|
|||
|
|||
## Quick Import
|
|||
|
|||
You can use Quick Import when you have data from external sources such as Airtable, CSV file or Microsoft Excel to an existing project by either
|
|||
|
|||
- Hover `Add new table` button in table menu, click three dots, use Quick Import to create
|
|||
- Drag and drop CSV, JSON or Excel file to import
|
|||
|
|||
<img width="1505" alt="image" src="https://user-images.githubusercontent.com/35857179/194795025-afd81191-4743-435b-b802-88367d2663f9.png" />
|
|||
|
|||
|
### Import Airtable into an Existing Project
|
||
|
|||
- See [here](/setup-and-usages/import-airtable-to-sql-database-within-a-minute-for-free)
|
|||
|
|||
|
### Import CSV data into an Existing Project
|
||
|
|||
- Hover `Add new table` button in table menu, click three dots, and click `CSV file`
|
|||
|
- Drag & drop or select files (at most 5 files) to upload or specify CSV file URL, and Click Import
|
||
- **Auto-Select Field Types**: If it is checked, column types will be detected. Otherwise, it will default to `SingleLineText`.
|
|||
- **Use First Row as Headers**: If it is checked, the first row will be treated as header row.
|
|||
- **Import Data**: If it is checked, all data will be imported. Otherwise, only table will be created.
|
|||
![image](https://user-images.githubusercontent.com/35857179/197454479-1ed18dce-1d0b-4ee3-88b3-9b6a132dea2a.png)
|
|||
- You can revise the table name by double clicking it, column name and column type. By default, the first column will be chosen as <a href="/setup-and-usages/display-value" target="_blank">Display Value</a> and cannot be deleted.
|
|||
|
![image](https://user-images.githubusercontent.com/35857179/197454633-5b30323e-2b13-4c55-843a-948c093d373e.png)
|
||
- Click `Import` to start importing process. The table will be created and the data will be imported.
|
|||
|
![image](https://user-images.githubusercontent.com/35857179/197455547-2d93df5e-a7f0-4c88-af53-990067625967.png)
|
||
|
|||
|
### Import Excel data into an Existing Project
|
||
|
|||
- Hover `Add new table` button in table menu, click three dots, and click `Microsoft Excel`
|
|||
|
- Drag & drop or select file (at most 1 file) to upload or specify Excel file URL and Click Import.
|
||
- **Auto-Select Field Types**: If it is checked, column types will be detected. Otherwise, it will default to `SingleLineText`.
|
|||
- **Use First Row as Headers**: If it is checked, the first row will be treated as header row.
|
|||
- **Import Data**: If it is checked, all data will be imported. Otherwise, only table will be created.
|
|||
![image](https://user-images.githubusercontent.com/35857179/197455788-8dd8a7d1-38f3-48c3-a05e-6ab0cf25045c.png)
|
|||
- You can revise the table name, column name and column type. By default, the first column will be chosen as <a href="/setup-and-usages/display-value" target="_blank">Display Value</a> and cannot be deleted.
|
|||
|
|||
:::note
|
|||
|
|||
If your Excel file contains multiple sheets, each sheet will be stored in a separate table.
|
|||
|
|||
:::
|
|||
|
|||
<img width="1449" alt="image" src="https://user-images.githubusercontent.com/35857179/194795771-77963196-8e10-4f45-b605-eb1089d6bc9b.png" />
|
|||
|
|||
- Click `Import` to start importing process. The table(s) will be created and the data will be imported to the corresponding table(s).
|
|||
|
|||
<img width="1508" alt="image" src="https://user-images.githubusercontent.com/35857179/194795789-80366467-9778-464b-bce0-a5c0dfe97522.png" />
|
|||
|
|||
## Export Data
|
|||
|
|||
You can export your data from a table as a CSV file by clicking the down arrow next to Table name and hover on `Download`. Currently only CSV and XLSX formats are supported for export.
|
|||
|
|||
<img width="660" alt="image" src="https://user-images.githubusercontent.com/35857179/194795866-a2db2a9b-d8e3-43f2-aec5-085e1932a0a5.png" />
|
|||
|
|||
## Import Data
|
|||
|
|||
You can import your data in CSV format to a table by clicking the down arrow next to Table name and hover on `Upload`. Currently only CSV format is supported for upload.
|
|||
|
|||
<img width="668" alt="image" src="https://user-images.githubusercontent.com/35857179/194795880-60bf2003-0bef-45cd-aafa-1b97adb75d42.png" />
|
|||
|
|