You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit fc1fff5
Browse filesBrowse the repository at this point in the historyBrowse files
Match database and table update docs to the code on development
databases.update and tables.update send a value only when it is not
empty on development, so the update docs say that empty strings do not
clear description or certification_note. Revert the "only the values
that are set" wording, which depends on unmerged #1901.
Co-Authored-By: Claude Code <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: docs/api-ref.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2475,7 +2475,7 @@ Name | Description
2475
2475
`contact_id` | The ID of the user who is the contact for the database. Settable; sent to the server by `databases.update`.
2476
2476
`content_permissions` | The permission mode of the database, as returned by the server. Must be one of `DatabaseItem.ContentPermissions.LockedToProject` (value `"LockedToDatabase"`) or `DatabaseItem.ContentPermissions.ManagedByOwner` (value `"ManagedByOwner"`). Can be set on the object, and `databases.update` sends it to the server.
2477
2477
`default_table_permissions` | The default permissions for tables in the database, as a list of `PermissionsRule` objects. You must first call `databases.populate_table_default_permissions` to access this data.
2478
-
`description` | The description of the database. Settable; sent to the server by `databases.update`. An empty string clears the description.
2478
+
`description` | The description of the database. Settable; sent to the server by `databases.update` when it is not empty.
2479
2479
`dqws` | The list of data quality warnings (`DQWItem`) for the database. You must first call `databases.populate_dqw` to access this data.
2480
2480
`embedded` | `True` if the database is embedded in Tableau content. Read-only.
2481
2481
`file_extension` | The file extension, for file-based databases. Read-only.
Updates the description, certification, certification note, and contact of the specified database.
2644
2644
2645
-
Only the values that are set on `database_item` are sent. A value of `None` leaves the matching property unchanged on the server, and an empty string for `description`or`certification_note`clears it. The `certified`, `description`, `certification_note`, `content_permissions`, and `contact_id` values can be updated. The `name`value is not sent.
2645
+
The request always includes the `certified` value, so set `database_item.certified` to `True` or `False` before you call this method. The `description`and`certification_note`values are sent only when they are not empty, so this method cannot clear them. The `name`and `content_permissions` values are not sent.
`certified` | `True` if the table is certified. Settable (must be a boolean); sent to the server by `tables.update`.
8578
8578
`columns` | The columns in the table, as an iterable of `ColumnItem` objects that fetches every page of columns from the server. You must first call `tables.populate_columns` to access this data.
8579
8579
`contact_id` | The ID of the user who is the contact for the table. Settable; sent to the server by `tables.update`.
8580
-
`description` | The description of the table. Settable; sent to the server by `tables.update`. An empty string clears the description.
8580
+
`description` | The description of the table. Settable; sent to the server by `tables.update` when it is not empty.
8581
8581
`dqws` | The list of data quality warnings (`DQWItem`) for the table. You must first call `tables.populate_dqw` to access this data.
8582
8582
`id` | The identifier (LUID) of the table. Read-only.
8583
8583
`name` | The name of the table. Must not be empty. `tables.update` does not send the name to the server.
@@ -8756,7 +8756,7 @@ tables.update(table_item)
8756
8756
8757
8757
Updates the description, certification, certification note, and contact of the specified table.
8758
8758
8759
-
Only the values that are set on `table_item` are sent. A value of `None` leaves the matching property unchanged on the server, and an empty string for `description`or`certification_note`clears it. The `certified`, `description`, `certification_note`, and `contact_id` values can be updated. The `name` value is not sent.
8759
+
The request always includes the `certified` value, so set `table_item.certified` to `True` or `False` before you call this method. The `description`and`certification_note`values are sent only when they are not empty, so this method cannot clear them. The `name` value is not sent.
0 commit comments