Repository: atlas Updated Branches: refs/heads/branch-1.0 a6a0348e6 -> 40804017b
ATLAS-2719: Update documentation on classification propagation to include entity delete cases (cherry picked from commit 6820cb7859da7ae4d9583de68e5d2df2eb757442) Project: http://git-wip-us.apache.org/repos/asf/atlas/repo Commit: http://git-wip-us.apache.org/repos/asf/atlas/commit/40804017 Tree: http://git-wip-us.apache.org/repos/asf/atlas/tree/40804017 Diff: http://git-wip-us.apache.org/repos/asf/atlas/diff/40804017 Branch: refs/heads/branch-1.0 Commit: 40804017bc6f962666a36ec02ec0bec50802ae29 Parents: a6a0348 Author: Sarath Subramanian <ssubraman...@hortonworks.com> Authored: Thu May 24 15:03:13 2018 -0700 Committer: Sarath Subramanian <ssubraman...@hortonworks.com> Committed: Thu May 24 15:03:46 2018 -0700 ---------------------------------------------------------------------- ...assification-propagation-entity-delete-1.png | Bin 0 -> 84846 bytes ...assification-propagation-entity-delete-2.png | Bin 0 -> 94985 bytes ...assification-propagation-entity-delete-3.png | Bin 0 -> 136134 bytes ...assification-propagation-entity-delete-4.png | Bin 0 -> 137723 bytes .../site/twiki/ClassificationPropagation.twiki | 24 ++++++++++++++++++- 5 files changed, 23 insertions(+), 1 deletion(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/atlas/blob/40804017/docs/src/site/resources/images/twiki/classification-propagation-entity-delete-1.png ---------------------------------------------------------------------- diff --git a/docs/src/site/resources/images/twiki/classification-propagation-entity-delete-1.png b/docs/src/site/resources/images/twiki/classification-propagation-entity-delete-1.png new file mode 100644 index 0000000..fab1095 Binary files /dev/null and b/docs/src/site/resources/images/twiki/classification-propagation-entity-delete-1.png differ http://git-wip-us.apache.org/repos/asf/atlas/blob/40804017/docs/src/site/resources/images/twiki/classification-propagation-entity-delete-2.png ---------------------------------------------------------------------- diff --git a/docs/src/site/resources/images/twiki/classification-propagation-entity-delete-2.png b/docs/src/site/resources/images/twiki/classification-propagation-entity-delete-2.png new file mode 100644 index 0000000..e43441f Binary files /dev/null and b/docs/src/site/resources/images/twiki/classification-propagation-entity-delete-2.png differ http://git-wip-us.apache.org/repos/asf/atlas/blob/40804017/docs/src/site/resources/images/twiki/classification-propagation-entity-delete-3.png ---------------------------------------------------------------------- diff --git a/docs/src/site/resources/images/twiki/classification-propagation-entity-delete-3.png b/docs/src/site/resources/images/twiki/classification-propagation-entity-delete-3.png new file mode 100644 index 0000000..b8a5663 Binary files /dev/null and b/docs/src/site/resources/images/twiki/classification-propagation-entity-delete-3.png differ http://git-wip-us.apache.org/repos/asf/atlas/blob/40804017/docs/src/site/resources/images/twiki/classification-propagation-entity-delete-4.png ---------------------------------------------------------------------- diff --git a/docs/src/site/resources/images/twiki/classification-propagation-entity-delete-4.png b/docs/src/site/resources/images/twiki/classification-propagation-entity-delete-4.png new file mode 100644 index 0000000..0dae3fe Binary files /dev/null and b/docs/src/site/resources/images/twiki/classification-propagation-entity-delete-4.png differ http://git-wip-us.apache.org/repos/asf/atlas/blob/40804017/docs/src/site/twiki/ClassificationPropagation.twiki ---------------------------------------------------------------------- diff --git a/docs/src/site/twiki/ClassificationPropagation.twiki b/docs/src/site/twiki/ClassificationPropagation.twiki index 75d6165..6c5d82a 100755 --- a/docs/src/site/twiki/ClassificationPropagation.twiki +++ b/docs/src/site/twiki/ClassificationPropagation.twiki @@ -42,13 +42,35 @@ created view as well. <img src="images/twiki/classification-propagation-5.png"/> ---++ Delete an entity +*Case 1:* When an entity is deleted, classifications associated with this entity will be removed from all entities the classifications are propagated to. For example. when _employees_ table is deleted, classifications associated with this table are removed from 'employees_view' view. -<img src="images/twiki/classification-propagation-6.png"/> +<img src="images/twiki/classification-propagation-6.png" width="800" style="margin-left:20px"></img> + +*Case 2:* +When an entity is deleted in the middle of a lineage path, the propagation link is broken and previously propagated +classifications will be removed from all derived entities of the deleted entity. + +For example. when 'us_employees' table is deleted, classifications propagating through this table (*PII*) are removed from +'ca_employees' table, since the only path of propagation is broken by entity deletion. + +<img src="images/twiki/classification-propagation-entity-delete-1.png" width="800" style="margin-left:20px"></img> + +<img src="images/twiki/classification-propagation-entity-delete-2.png" width="800" style="margin-left:20px"></img> + +*Case 3:* +When an entity is deleted in the middle of a lineage path and if there exists alternate path for propagation, previously propagated classifications will be retained. + +For example. when 'us_employees' table is deleted, classifications propagating (*PII*) through this table are retained in +'ca_employees' table, since there are two propagation paths available and only one of them is broken by entity deletion. + +<img src="images/twiki/classification-propagation-entity-delete-3.png" width="800" style="margin-left:20px"></img> + +<img src="images/twiki/classification-propagation-entity-delete-4.png" width="800" style="margin-left:20px"></img> ---++ Control Propagation Apache Atlas provides few options to control whether/where a classification is propagated.